letta-nightly 0.12.1.dev20251023104211__py3-none-any.whl → 0.13.0.dev20251024223017__py3-none-any.whl

letta/orm/identity.py

@@ -44,15 +44,15 @@ class Identity(SqlalchemyBase, OrganizationMixin, ProjectMixin):
         "Block", secondary="identities_blocks", lazy="selectin", passive_deletes=True, back_populates="identities"
     )
 
-    @property
-    def agent_ids(self) -> List[str]:
-        """Get just the agent IDs without loading the full agent objects"""
-        return [agent.id for agent in self.agents]
+    # @property
+    # def agent_ids(self) -> List[str]:
+    #     """Get just the agent IDs without loading the full agent objects"""
+    #     return [agent.id for agent in self.agents]
 
-    @property
-    def block_ids(self) -> List[str]:
-        """Get just the block IDs without loading the full agent objects"""
-        return [block.id for block in self.blocks]
+    # @property
+    # def block_ids(self) -> List[str]:
+    #     """Get just the block IDs without loading the full agent objects"""
+    #     return [block.id for block in self.blocks]
 
     def to_pydantic(self) -> PydanticIdentity:
         state = {
@@ -61,9 +61,9 @@ class Identity(SqlalchemyBase, OrganizationMixin, ProjectMixin):
             "name": self.name,
             "identity_type": self.identity_type,
             "project_id": self.project_id,
-            "agent_ids": self.agent_ids,
-            "block_ids": self.block_ids,
+            "agent_ids": [],
+            "block_ids": [],
             "organization_id": self.organization_id,
-            "properties": self.properties,
+            "properties": self.properties or [],
         }
         return PydanticIdentity(**state)

letta/orm/mcp_server.py

@@ -56,3 +56,12 @@ class MCPServer(SqlalchemyBase, OrganizationMixin):
     metadata_: Mapped[Optional[dict]] = mapped_column(
         JSON, default=lambda: {}, doc="A dictionary of additional metadata for the MCP server."
     )
+
+
+class MCPTools(SqlalchemyBase, OrganizationMixin):
+    """Represents a mapping of MCP server ID to tool ID"""
+
+    __tablename__ = "mcp_tools"
+
+    mcp_server_id: Mapped[str] = mapped_column(String, doc="The ID of the MCP server")
+    tool_id: Mapped[str] = mapped_column(String, doc="The ID of the tool")

letta/orm/message.py

@@ -4,10 +4,11 @@ from openai.types.chat.chat_completion_message_tool_call import ChatCompletionMe
 from sqlalchemy import BigInteger, FetchedValue, ForeignKey, Index, event, text
 from sqlalchemy.orm import Mapped, Session, mapped_column, relationship
 
-from letta.orm.custom_columns import MessageContentColumn, ToolCallColumn, ToolReturnColumn
+from letta.orm.custom_columns import ApprovalsColumn, MessageContentColumn, ToolCallColumn, ToolReturnColumn
 from letta.orm.mixins import AgentMixin, OrganizationMixin
 from letta.orm.sqlalchemy_base import SqlalchemyBase
 from letta.schemas.enums import MessageRole
+from letta.schemas.letta_message import ApprovalReturn
 from letta.schemas.letta_message_content import MessageContent, TextContent, TextContent as PydanticTextContent
 from letta.schemas.message import Message as PydanticMessage, ToolReturn
 from letta.settings import DatabaseChoice, settings
@@ -63,6 +64,9 @@ class Message(SqlalchemyBase, OrganizationMixin, AgentMixin):
     )
     approve: Mapped[Optional[bool]] = mapped_column(nullable=True, doc="Whether tool call is approved.")
     denial_reason: Mapped[Optional[str]] = mapped_column(nullable=True, doc="The reason the tool call request was denied.")
+    approvals: Mapped[Optional[List[ApprovalReturn | ToolReturn]]] = mapped_column(
+        ApprovalsColumn, nullable=True, doc="Approval responses for tool call requests"
+    )
 
     # Monotonically increasing sequence for efficient/correct listing
     sequence_id: Mapped[int] = mapped_column(
@@ -100,6 +104,7 @@ class Message(SqlalchemyBase, OrganizationMixin, AgentMixin):
             and len(self.content) == 1
             and isinstance(self.content[0], TextContent)
         ):
+            self.tool_call_id = self.tool_returns[0].tool_call_id
             self.tool_returns[0].func_response = self.content[0].text
 
         return model

letta/orm/run_metrics.py

@@ -1,7 +1,7 @@
 from datetime import datetime, timezone
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING, List, Optional
 
-from sqlalchemy import BigInteger, ForeignKey, Integer, String
+from sqlalchemy import JSON, BigInteger, ForeignKey, Integer, String
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import Mapped, Session, mapped_column, relationship
 
@@ -43,6 +43,11 @@ class RunMetrics(SqlalchemyBase, ProjectMixin, AgentMixin, OrganizationMixin, Te
         nullable=True,
         doc="The number of steps in the run",
     )
+    tools_used: Mapped[Optional[List[str]]] = mapped_column(
+        JSON,
+        nullable=True,
+        doc="List of tool IDs that were used in this run",
+    )
     run: Mapped[Optional["Run"]] = relationship("Run", foreign_keys=[id])
     agent: Mapped[Optional["Agent"]] = relationship("Agent")
 

letta/orm/sqlalchemy_base.py

@@ -269,14 +269,14 @@ class SqlalchemyBase(CommonSqlalchemyMetaMixins, Base):
                 if before_obj:
                     conditions.append(
                         or_(
-                            cls.created_at < before_obj.created_at,
+                            cls.created_at < before_obj.created_at if ascending else cls.created_at > before_obj.created_at,
                             and_(cls.created_at == before_obj.created_at, cls.id < before_obj.id),
                         )
                     )
                 if after_obj:
                     conditions.append(
                         or_(
-                            cls.created_at > after_obj.created_at,
+                            cls.created_at > after_obj.created_at if ascending else cls.created_at < after_obj.created_at,
                             and_(cls.created_at == after_obj.created_at, cls.id > after_obj.id),
                         )
                     )

letta/orm/tool.py

@@ -50,6 +50,9 @@ class Tool(SqlalchemyBase, OrganizationMixin):
     )
     npm_requirements: Mapped[list | None] = mapped_column(JSON, doc="Optional list of npm packages required by this tool.")
     default_requires_approval: Mapped[bool] = mapped_column(nullable=True, doc="Whether or not to require approval.")
+    enable_parallel_execution: Mapped[bool] = mapped_column(
+        nullable=True, doc="If set to True, then this tool will potentially be executed concurrently with other tools. Default False."
+    )
     metadata_: Mapped[Optional[dict]] = mapped_column(JSON, default=lambda: {}, doc="A dictionary of additional metadata for the tool.")
     # relationships
     organization: Mapped["Organization"] = relationship("Organization", back_populates="tools", lazy="selectin")

letta/otel/tracing.py

@@ -87,6 +87,8 @@ async def _update_trace_attributes(request: Request):
         "x-template-id": "template.id",
         "x-base-template-id": "base_template.id",
         "user-agent": "client",
+        "x-stainless-package-version": "sdk.version",
+        "x-stainless-lang": "sdk.language",
     }
     for header_key, span_key in header_attributes.items():
         header_value = request.headers.get(header_key)

letta/prompts/prompt_generator.py

@@ -1,6 +1,10 @@
 from datetime import datetime
 from typing import List, Literal, Optional
 
+from letta.log import get_logger
+
+logger = get_logger(__name__)
+
 from letta.constants import IN_CONTEXT_MEMORY_KEYWORD
 from letta.helpers import ToolRulesSolver
 from letta.helpers.datetime_helpers import format_datetime, get_local_time_fast
@@ -137,7 +141,7 @@ class PromptGenerator:
             if append_icm_if_missing:
                 if memory_variable_string not in system_prompt:
                     # In this case, append it to the end to make sure memory is still injected
-                    # warnings.warn(f"{IN_CONTEXT_MEMORY_KEYWORD} variable was missing from system prompt, appending instead")
+                    # logger.warning(f"{IN_CONTEXT_MEMORY_KEYWORD} variable was missing from system prompt, appending instead")
                     system_prompt += "\n\n" + memory_variable_string
 
             # render the variables using the built-in templater
@@ -170,6 +174,7 @@ class PromptGenerator:
         tool_rules_solver: Optional[ToolRulesSolver] = None,
         sources: Optional[List] = None,
         max_files_open: Optional[int] = None,
+        llm_config: Optional[object] = None,
     ) -> str:
         tool_constraint_block = None
         if tool_rules_solver is not None:
@@ -182,7 +187,7 @@ class PromptGenerator:
             pass
 
         memory_with_sources = in_context_memory.compile(
-            tool_usage_rules=tool_constraint_block, sources=sources, max_files_open=max_files_open
+            tool_usage_rules=tool_constraint_block, sources=sources, max_files_open=max_files_open, llm_config=llm_config
         )
 
         return PromptGenerator.get_system_message_from_compiled_memory(

letta/schemas/agent.py

@@ -1,15 +1,18 @@
 from datetime import datetime
 from enum import Enum
-from typing import Dict, List, Optional
+from typing import Dict, List, Literal, Optional
 
 from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
 
 from letta.constants import CORE_MEMORY_LINE_NUMBER_WARNING, DEFAULT_EMBEDDING_CHUNK_SIZE
-from letta.schemas.block import CreateBlock
+from letta.errors import AgentExportProcessingError
+from letta.schemas.block import Block, CreateBlock
 from letta.schemas.embedding_config import EmbeddingConfig
+from letta.schemas.enums import PrimitiveType
 from letta.schemas.environment_variables import AgentEnvironmentVariable
 from letta.schemas.file import FileStatus
 from letta.schemas.group import Group
+from letta.schemas.identity import Identity
 from letta.schemas.letta_base import OrmMetadataBase
 from letta.schemas.llm_config import LLMConfig
 from letta.schemas.memory import Memory
@@ -40,6 +43,18 @@ class AgentType(str, Enum):
     voice_sleeptime_agent = "voice_sleeptime_agent"
 
 
+# Relationship field literal type for AgentState include field to join related objects
+AgentRelationships = Literal[
+    "agent.blocks",
+    "agent.identities",
+    "agent.managed_group",
+    "agent.secrets",
+    "agent.sources",
+    "agent.tags",
+    "agent.tools",
+]
+
+
 class AgentState(OrmMetadataBase, validate_assignment=True):
     """
     Representation of an agent's state. This is the state of the agent at a given time, and is persisted in the DB backend. The state has all the information needed to recreate a persisted agent.
@@ -56,7 +71,7 @@ class AgentState(OrmMetadataBase, validate_assignment=True):
         embedding_config (EmbeddingConfig): The embedding configuration used by the agent.
     """
 
-    __id_prefix__ = "agent"
+    __id_prefix__ = PrimitiveType.AGENT.value
 
     # NOTE: this is what is returned to the client and also what is used to initialize `Agent`
     id: str = Field(..., description="The id of the agent. Assigned by the database.")
@@ -84,7 +99,8 @@ class AgentState(OrmMetadataBase, validate_assignment=True):
     description: Optional[str] = Field(None, description="The description of the agent.")
     metadata: Optional[Dict] = Field(None, description="The metadata of the agent.")
 
-    memory: Memory = Field(..., description="The in-context memory of the agent.")
+    memory: Memory = Field(..., description="The in-context memory of the agent.", deprecated=True)
+    blocks: List[Block] = Field(..., description="The memory blocks used by the agent.")
     tools: List[Tool] = Field(..., description="The tools used by the agent.")
     sources: List[Source] = Field(..., description="The sources used by the agent.")
     tags: List[str] = Field(..., description="The tags associated with the agent.")
@@ -101,7 +117,8 @@ class AgentState(OrmMetadataBase, validate_assignment=True):
     base_template_id: Optional[str] = Field(None, description="The base template id of the agent.")
     deployment_id: Optional[str] = Field(None, description="The id of the deployment.")
     entity_id: Optional[str] = Field(None, description="The id of the entity within the template.")
-    identity_ids: List[str] = Field([], description="The ids of the identities associated with this agent.")
+    identity_ids: List[str] = Field([], description="The ids of the identities associated with this agent.", deprecated=True)
+    identities: List[Identity] = Field([], description="The identities associated with this agent.")
 
     # An advanced configuration that makes it so this agent does not remember any previous messages
     message_buffer_autoclear: bool = Field(
@@ -113,8 +130,8 @@ class AgentState(OrmMetadataBase, validate_assignment=True):
         description="If set to True, memory management will move to a background agent thread.",
     )
 
-    multi_agent_group: Optional[Group] = Field(None, description="The multi-agent group that this agent manages")
-
+    multi_agent_group: Optional[Group] = Field(None, description="The multi-agent group that this agent manages", deprecated=True)
+    managed_group: Optional[Group] = Field(None, description="The multi-agent group that this agent manages")
     # Run metrics
     last_run_completion: Optional[datetime] = Field(None, description="The timestamp when the agent last completed a run.")
     last_run_duration_ms: Optional[int] = Field(None, description="The duration in milliseconds of the agent's last run.")
@@ -256,6 +273,7 @@ class CreateAgent(BaseModel, validate_assignment=True):  #
         None,
         description="If set to True, the agent will be hidden.",
     )
+    parallel_tool_calls: Optional[bool] = Field(False, description="If set to True, enables parallel tool calling. Defaults to False.")
 
     @field_validator("name")
     @classmethod
@@ -268,9 +286,16 @@ class CreateAgent(BaseModel, validate_assignment=True):  #
             # don't check if not provided
             return name
 
-        # Regex for allowed characters (alphanumeric, spaces, hyphens, underscores)
-        if not re.match("^[A-Za-z0-9 _-]+$", name):
-            raise ValueError("Name contains invalid characters.")
+        # Regex for allowed characters (Unicode letters, digits, spaces, hyphens, underscores, apostrophes)
+        # \w in Python 3 with re.UNICODE matches Unicode letters, digits, and underscores
+        # We explicitly allow: letters (any language), digits, spaces, hyphens, underscores, apostrophes
+        # We block filesystem-unsafe characters: / \ : * ? " < > |
+        if not re.match(r"^[\w '\-]+$", name, re.UNICODE):
+            raise AgentExportProcessingError(
+                f"Agent name '{name}' contains invalid characters. Only letters (any language), digits, spaces, "
+                f"hyphens, underscores, and apostrophes are allowed. Please avoid filesystem-unsafe characters "
+                f'like: / \\ : * ? " < > |'
+            )
 
         # Further checks can be added here...
         # TODO
@@ -353,6 +378,11 @@ class UpdateAgent(BaseModel):
     embedding: Optional[str] = Field(
         None, description="The embedding configuration handle used by the agent, specified in the format provider/model-name."
     )
+    context_window_limit: Optional[int] = Field(None, description="The context window limit used by the agent.")
+    max_tokens: Optional[int] = Field(
+        None,
+        description="The maximum number of tokens to generate, including reasoning step. If not set, the model will use its default value.",
+    )
     reasoning: Optional[bool] = Field(None, description="Whether to enable reasoning for this agent.")
     enable_sleeptime: Optional[bool] = Field(None, description="If set to True, memory management will move to a background agent thread.")
     response_format: Optional[ResponseFormatUnion] = Field(None, description="The response format for the agent.")
@@ -371,6 +401,7 @@ class UpdateAgent(BaseModel):
         None,
         description="If set to True, the agent will be hidden.",
     )
+    parallel_tool_calls: Optional[bool] = Field(False, description="If set to True, enables parallel tool calling. Defaults to False.")
 
     model_config = ConfigDict(extra="ignore")  # Ignores extra fields
 

letta/schemas/agent_file.py

@@ -10,6 +10,7 @@ from letta.schemas.block import Block, CreateBlock
 from letta.schemas.enums import MessageRole
 from letta.schemas.file import FileAgent, FileAgentBase, FileMetadata, FileMetadataBase
 from letta.schemas.group import Group, GroupCreate
+from letta.schemas.letta_message import ApprovalReturn
 from letta.schemas.mcp import MCPServer
 from letta.schemas.message import Message, MessageCreate, ToolReturn
 from letta.schemas.source import Source, SourceCreate
@@ -59,6 +60,7 @@ class MessageSchema(MessageCreate):
     approve: Optional[bool] = Field(None, description="Whether the tool has been approved")
     approval_request_id: Optional[str] = Field(None, description="The message ID of the approval request")
     denial_reason: Optional[str] = Field(None, description="An optional explanation for the provided approval status")
+    approvals: Optional[List[ApprovalReturn | ToolReturn]] = Field(None, description="Approval returns for the message")
 
     # TODO: Should we also duplicate the steps here?
     # TODO: What about tool_return?
@@ -87,6 +89,7 @@ class MessageSchema(MessageCreate):
             approve=message.approve,
             approval_request_id=message.approval_request_id,
             denial_reason=message.denial_reason,
+            approvals=message.approvals,
         )
 
 

letta/schemas/archive.py

@@ -3,12 +3,13 @@ from typing import Dict, Optional
 
 from pydantic import Field
 
-from letta.schemas.enums import VectorDBProvider
+from letta.schemas.embedding_config import EmbeddingConfig
+from letta.schemas.enums import PrimitiveType, VectorDBProvider
 from letta.schemas.letta_base import OrmMetadataBase
 
 
 class ArchiveBase(OrmMetadataBase):
-    __id_prefix__ = "archive"
+    __id_prefix__ = PrimitiveType.ARCHIVE.value
 
     name: str = Field(..., description="The name of the archive")
     description: Optional[str] = Field(None, description="A description of the archive")
@@ -16,6 +17,7 @@ class ArchiveBase(OrmMetadataBase):
     vector_db_provider: VectorDBProvider = Field(
         default=VectorDBProvider.NATIVE, description="The vector database provider used for this archive's passages"
     )
+    embedding_config: EmbeddingConfig = Field(..., description="Embedding configuration for passages in this archive")
     metadata: Optional[Dict] = Field(default_factory=dict, validation_alias="metadata_", description="Additional metadata")
 
 

letta/schemas/block.py

@@ -4,6 +4,7 @@ from typing import Any, Optional
 from pydantic import ConfigDict, Field, model_validator
 
 from letta.constants import CORE_MEMORY_BLOCK_CHAR_LIMIT, DEFAULT_HUMAN_BLOCK_DESCRIPTION, DEFAULT_PERSONA_BLOCK_DESCRIPTION
+from letta.schemas.enums import PrimitiveType
 from letta.schemas.letta_base import LettaBase
 
 # block of the LLM context
@@ -12,7 +13,7 @@ from letta.schemas.letta_base import LettaBase
 class BaseBlock(LettaBase, validate_assignment=True):
     """Base block of the LLM context"""
 
-    __id_prefix__ = "block"
+    __id_prefix__ = PrimitiveType.BLOCK.value
 
     # data value
     value: str = Field(..., description="Value of the block.")

letta/schemas/enums.py

@@ -1,6 +1,32 @@
 from enum import Enum, StrEnum
 
 
+class PrimitiveType(str, Enum):
+    """
+    Enum for all primitive resource types in Letta.
+
+    The enum values ARE the actual ID prefixes used in the system.
+    This serves as the single source of truth for all ID prefixes.
+    """
+
+    AGENT = "agent"
+    MESSAGE = "message"
+    RUN = "run"
+    JOB = "job"
+    GROUP = "group"
+    BLOCK = "block"
+    FILE = "file"
+    FOLDER = "source"  # Note: folder IDs use "source" prefix for historical reasons
+    SOURCE = "source"
+    TOOL = "tool"
+    ARCHIVE = "archive"
+    PASSAGE = "passage"
+    PROVIDER = "provider"
+    SANDBOX_CONFIG = "sandbox"  # Note: sandbox_config IDs use "sandbox" prefix
+    STEP = "step"
+    IDENTITY = "identity"
+
+
 class ProviderType(str, Enum):
     anthropic = "anthropic"
     azure = "azure"
@@ -152,13 +178,12 @@ class ToolType(str, Enum):
     LETTA_VOICE_SLEEPTIME_CORE = "letta_voice_sleeptime_core"
     LETTA_BUILTIN = "letta_builtin"
     LETTA_FILES_CORE = "letta_files_core"
-    EXTERNAL_LANGCHAIN = "external_langchain" # DEPRECATED
-    EXTERNAL_COMPOSIO = "external_composio" # DEPRECATED
+    EXTERNAL_LANGCHAIN = "external_langchain"  # DEPRECATED
+    EXTERNAL_COMPOSIO = "external_composio"  # DEPRECATED
     # TODO is "external" the right name here? Since as of now, MCP is local / doesn't support remote?
     EXTERNAL_MCP = "external_mcp"
 
 
-
 class JobType(str, Enum):
     JOB = "job"
     RUN = "run"
@@ -222,3 +247,11 @@ class TagMatchMode(str, Enum):
 
     ANY = "any"
     ALL = "all"
+
+
+class ComparisonOperator(str, Enum):
+    """Comparison operators for filtering numeric values"""
+
+    EQ = "eq"  # equals
+    GTE = "gte"  # greater than or equal
+    LTE = "lte"  # less than or equal

letta/schemas/file.py

@@ -4,7 +4,7 @@ from typing import List, Optional
 
 from pydantic import Field
 
-from letta.schemas.enums import FileProcessingStatus
+from letta.schemas.enums import FileProcessingStatus, PrimitiveType
 from letta.schemas.letta_base import LettaBase
 
 
@@ -20,7 +20,7 @@ class FileStatus(str, Enum):
 class FileMetadataBase(LettaBase):
     """Base class for FileMetadata schemas"""
 
-    __id_prefix__ = "file"
+    __id_prefix__ = PrimitiveType.FILE.value
 
     # Core file metadata fields
     source_id: str = Field(..., description="The unique identifier of the source associated with the document.")
@@ -61,7 +61,7 @@ class FileMetadata(FileMetadataBase):
 class FileAgentBase(LettaBase):
     """Base class for the FileMetadata-⇄-Agent association schemas"""
 
-    __id_prefix__ = "file_agent"
+    __id_prefix__ = PrimitiveType.FILE.value
 
     # Core file-agent association fields
     agent_id: str = Field(..., description="Unique identifier of the agent.")

letta/schemas/folder.py

@@ -4,6 +4,7 @@ from typing import Optional
 from pydantic import Field
 
 from letta.schemas.embedding_config import EmbeddingConfig
+from letta.schemas.enums import PrimitiveType
 from letta.schemas.letta_base import LettaBase
 
 
@@ -12,7 +13,7 @@ class BaseFolder(LettaBase):
     Shared attributes across all folder schemas.
     """
 
-    __id_prefix__ = "source"  # TODO: change to "folder"
+    __id_prefix__ = PrimitiveType.FOLDER.value  # TODO: change to "folder"
 
     # Core folder fields
     name: str = Field(..., description="The name of the folder.")

letta/schemas/group.py

@@ -3,6 +3,7 @@ from typing import Annotated, List, Literal, Optional, Union
 
 from pydantic import BaseModel, Field
 
+from letta.schemas.enums import PrimitiveType
 from letta.schemas.letta_base import LettaBase
 
 
@@ -20,7 +21,7 @@ class ManagerConfig(BaseModel):
 
 
 class GroupBase(LettaBase):
-    __id_prefix__ = "group"
+    __id_prefix__ = PrimitiveType.GROUP.value
 
 
 class Group(GroupBase):

letta/schemas/identity.py

@@ -3,6 +3,7 @@ from typing import List, Optional, Union
 
 from pydantic import Field
 
+from letta.schemas.enums import PrimitiveType
 from letta.schemas.letta_base import LettaBase
 
 
@@ -28,7 +29,7 @@ class IdentityPropertyType(str, Enum):
 
 
 class IdentityBase(LettaBase):
-    __id_prefix__ = "identity"
+    __id_prefix__ = PrimitiveType.IDENTITY.value
 
 
 class IdentityProperty(LettaBase):
@@ -45,8 +46,8 @@ class Identity(IdentityBase):
     name: str = Field(..., description="The name of the identity.")
     identity_type: IdentityType = Field(..., description="The type of the identity.")
     project_id: Optional[str] = Field(None, description="The project id of the identity, if applicable.")
-    agent_ids: List[str] = Field(..., description="The IDs of the agents associated with the identity.")
-    block_ids: List[str] = Field(..., description="The IDs of the blocks associated with the identity.")
+    agent_ids: List[str] = Field(..., description="The IDs of the agents associated with the identity.", deprecated=True)
+    block_ids: List[str] = Field(..., description="The IDs of the blocks associated with the identity.", deprecated=True)
     organization_id: Optional[str] = Field(None, description="The organization id of the user")
     properties: List[IdentityProperty] = Field(default_factory=list, description="List of properties associated with the identity")
 
@@ -56,8 +57,8 @@ class IdentityCreate(LettaBase):
     name: str = Field(..., description="The name of the identity.")
     identity_type: IdentityType = Field(..., description="The type of the identity.")
     project_id: Optional[str] = Field(None, description="The project id of the identity, if applicable.")
-    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.")
-    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.")
+    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.", deprecated=True)
+    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.", deprecated=True)
     properties: Optional[List[IdentityProperty]] = Field(None, description="List of properties associated with the identity.")
 
 
@@ -66,8 +67,8 @@ class IdentityUpsert(LettaBase):
     name: str = Field(..., description="The name of the identity.")
     identity_type: IdentityType = Field(..., description="The type of the identity.")
     project_id: Optional[str] = Field(None, description="The project id of the identity, if applicable.")
-    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.")
-    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.")
+    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.", deprecated=True)
+    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.", deprecated=True)
     properties: Optional[List[IdentityProperty]] = Field(None, description="List of properties associated with the identity.")
 
 
@@ -75,6 +76,14 @@ class IdentityUpdate(LettaBase):
     identifier_key: Optional[str] = Field(None, description="External, user-generated identifier key of the identity.")
     name: Optional[str] = Field(None, description="The name of the identity.")
     identity_type: Optional[IdentityType] = Field(None, description="The type of the identity.")
-    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.")
-    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.")
+    agent_ids: Optional[List[str]] = Field(None, description="The agent ids that are associated with the identity.", deprecated=True)
+    block_ids: Optional[List[str]] = Field(None, description="The IDs of the blocks associated with the identity.", deprecated=True)
     properties: Optional[List[IdentityProperty]] = Field(None, description="List of properties associated with the identity.")
+
+
+class PaginatedIdentities(LettaBase):
+    """Paginated response for identities"""
+
+    data: List[Identity] = Field(..., description="List of identities")
+    next_cursor: Optional[str] = Field(None, description="Cursor for fetching the next page")
+    has_more: bool = Field(..., description="Whether more results exist after this page")

letta/schemas/job.py

@@ -3,6 +3,8 @@ from typing import TYPE_CHECKING, List, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
+from letta.schemas.enums import PrimitiveType
+
 if TYPE_CHECKING:
     from letta.schemas.letta_request import LettaRequest
 
@@ -15,7 +17,7 @@ from letta.schemas.letta_stop_reason import StopReasonType
 
 
 class JobBase(OrmMetadataBase):
-    __id_prefix__ = "job"
+    __id_prefix__ = PrimitiveType.JOB.value
     status: JobStatus = Field(default=JobStatus.created, description="The status of the job.")
     created_at: datetime = Field(default_factory=get_utc_time, description="The unix timestamp of when the job was created.")