letta-client 1.0.0a5__py3-none-any.whl → 1.0.0a7__py3-none-any.whl

letta_client/types/folder_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .folder import Folder
+
+__all__ = ["FolderListResponse"]
+
+FolderListResponse: TypeAlias = List[Folder]

letta_client/types/folder_update_params.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import TypedDict
+
+from .embedding_config_param import EmbeddingConfigParam
+
+__all__ = ["FolderUpdateParams"]
+
+
+class FolderUpdateParams(TypedDict, total=False):
+    description: Optional[str]
+    """The description of the source."""
+
+    embedding_config: Optional[EmbeddingConfigParam]
+    """Configuration for embedding model connection and processing parameters."""
+
+    instructions: Optional[str]
+    """Instructions for how to use the source."""
+
+    metadata: Optional[Dict[str, object]]
+    """Metadata associated with the source."""
+
+    name: Optional[str]
+    """The name of the source."""

letta_client/types/folders/__init__.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .file_list_params import FileListParams as FileListParams
+from .agent_list_params import AgentListParams as AgentListParams
+from .file_list_response import FileListResponse as FileListResponse
+from .file_upload_params import FileUploadParams as FileUploadParams
+from .agent_list_response import AgentListResponse as AgentListResponse
+from .file_upload_response import FileUploadResponse as FileUploadResponse

letta_client/types/folders/agent_list_params.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["AgentListParams"]
+
+
+class AgentListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Agent ID cursor for pagination.
+
+    Returns agents that come after this agent ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Agent ID cursor for pagination.
+
+    Returns agents that come before this agent ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of agents to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for agents by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/folders/agent_list_response.py

@@ -0,0 +1,8 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+__all__ = ["AgentListResponse"]
+
+AgentListResponse: TypeAlias = List[str]

letta_client/types/folders/file_list_params.py

@@ -0,0 +1,37 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["FileListParams"]
+
+
+class FileListParams(TypedDict, total=False):
+    after: Optional[str]
+    """File ID cursor for pagination.
+
+    Returns files that come after this file ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """File ID cursor for pagination.
+
+    Returns files that come before this file ID in the specified sort order
+    """
+
+    include_content: bool
+    """Whether to include full file content"""
+
+    limit: Optional[int]
+    """Maximum number of files to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for files by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/folders/file_list_response.py

@@ -0,0 +1,68 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = ["FileListResponse", "FileListResponseItem"]
+
+
+class FileListResponseItem(BaseModel):
+    source_id: str
+    """The unique identifier of the source associated with the document."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the File"""
+
+    chunks_embedded: Optional[int] = None
+    """Number of chunks that have been embedded."""
+
+    content: Optional[str] = None
+    """
+    Optional full-text content of the file; only populated on demand due to its
+    size.
+    """
+
+    created_at: Optional[datetime] = None
+    """The creation date of the file."""
+
+    error_message: Optional[str] = None
+    """Optional error message if the file failed processing."""
+
+    file_creation_date: Optional[str] = None
+    """The creation date of the file."""
+
+    file_last_modified_date: Optional[str] = None
+    """The last modified date of the file."""
+
+    file_name: Optional[str] = None
+    """The name of the file."""
+
+    file_path: Optional[str] = None
+    """The path to the file."""
+
+    file_size: Optional[int] = None
+    """The size of the file in bytes."""
+
+    file_type: Optional[str] = None
+    """The type of the file (MIME type)."""
+
+    original_file_name: Optional[str] = None
+    """The original name of the file as uploaded."""
+
+    processing_status: Optional[Literal["pending", "parsing", "embedding", "completed", "error"]] = None
+    """The current processing status of the file (e.g.
+
+    pending, parsing, embedding, completed, error).
+    """
+
+    total_chunks: Optional[int] = None
+    """Total number of chunks for the file."""
+
+    updated_at: Optional[datetime] = None
+    """The update date of the file."""
+
+
+FileListResponse: TypeAlias = List[FileListResponseItem]

letta_client/types/folders/file_upload_params.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from ..._types import FileTypes
+
+__all__ = ["FileUploadParams"]
+
+
+class FileUploadParams(TypedDict, total=False):
+    file: Required[FileTypes]
+
+    duplicate_handling: Literal["skip", "error", "suffix", "replace"]
+    """How to handle duplicate filenames"""
+
+    name: Optional[str]
+    """Optional custom name to override the uploaded file's name"""

letta_client/types/folders/file_upload_response.py

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["FileUploadResponse"]
+
+
+class FileUploadResponse(BaseModel):
+    source_id: str
+    """The unique identifier of the source associated with the document."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the File"""
+
+    chunks_embedded: Optional[int] = None
+    """Number of chunks that have been embedded."""
+
+    content: Optional[str] = None
+    """
+    Optional full-text content of the file; only populated on demand due to its
+    size.
+    """
+
+    created_at: Optional[datetime] = None
+    """The creation date of the file."""
+
+    error_message: Optional[str] = None
+    """Optional error message if the file failed processing."""
+
+    file_creation_date: Optional[str] = None
+    """The creation date of the file."""
+
+    file_last_modified_date: Optional[str] = None
+    """The last modified date of the file."""
+
+    file_name: Optional[str] = None
+    """The name of the file."""
+
+    file_path: Optional[str] = None
+    """The path to the file."""
+
+    file_size: Optional[int] = None
+    """The size of the file in bytes."""
+
+    file_type: Optional[str] = None
+    """The type of the file (MIME type)."""
+
+    original_file_name: Optional[str] = None
+    """The original name of the file as uploaded."""
+
+    processing_status: Optional[Literal["pending", "parsing", "embedding", "completed", "error"]] = None
+    """The current processing status of the file (e.g.
+
+    pending, parsing, embedding, completed, error).
+    """
+
+    total_chunks: Optional[int] = None
+    """Total number of chunks for the file."""
+
+    updated_at: Optional[datetime] = None
+    """The update date of the file."""

letta_client/types/group.py

@@ -1,109 +1,61 @@
-# This file was auto-generated by Fern from our API Definition.
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import typing
+from typing import List, Optional
 
-import pydantic
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-from ..core.unchecked_base_model import UncheckedBaseModel
+from .._models import BaseModel
 from .manager_type import ManagerType
 
+__all__ = ["Group"]
 
-class Group(UncheckedBaseModel):
-    id: str = pydantic.Field()
-    """
-    The id of the group. Assigned by the database.
-    """
 
-    manager_type: ManagerType = pydantic.Field()
-    """
-    
-    """
+class Group(BaseModel):
+    id: str
+    """The id of the group. Assigned by the database."""
 
-    agent_ids: typing.List[str] = pydantic.Field()
-    """
-    
-    """
+    agent_ids: List[str]
 
-    description: str = pydantic.Field()
-    """
-    
-    """
+    description: str
 
-    project_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The associated project id.
-    """
+    manager_type: ManagerType
 
-    template_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The id of the template.
-    """
+    base_template_id: Optional[str] = None
+    """The base template id."""
 
-    base_template_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The base template id.
-    """
+    deployment_id: Optional[str] = None
+    """The id of the deployment."""
 
-    deployment_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The id of the deployment.
-    """
+    hidden: Optional[bool] = None
+    """If set to True, the group will be hidden."""
 
-    shared_block_ids: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
-    """
-    
-    """
+    last_processed_message_id: Optional[str] = None
 
-    manager_agent_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    
-    """
+    manager_agent_id: Optional[str] = None
 
-    termination_token: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    
-    """
+    max_message_buffer_length: Optional[int] = None
+    """The desired maximum length of messages in the context window of the convo agent.
 
-    max_turns: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    
+    This is a best effort, and may be off slightly due to user/assistant
+    interleaving.
     """
 
-    sleeptime_agent_frequency: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    
-    """
+    max_turns: Optional[int] = None
 
-    turns_counter: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    
-    """
+    min_message_buffer_length: Optional[int] = None
+    """The desired minimum length of messages in the context window of the convo agent.
 
-    last_processed_message_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    
+    This is a best effort, and may be off-by-one due to user/assistant interleaving.
     """
 
-    max_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired maximum length of messages in the context window of the convo agent. This is a best effort, and may be off slightly due to user/assistant interleaving.
-    """
+    project_id: Optional[str] = None
+    """The associated project id."""
 
-    min_message_buffer_length: typing.Optional[int] = pydantic.Field(default=None)
-    """
-    The desired minimum length of messages in the context window of the convo agent. This is a best effort, and may be off-by-one due to user/assistant interleaving.
-    """
+    shared_block_ids: Optional[List[str]] = None
 
-    hidden: typing.Optional[bool] = pydantic.Field(default=None)
-    """
-    If set to True, the group will be hidden.
-    """
+    sleeptime_agent_frequency: Optional[int] = None
+
+    template_id: Optional[str] = None
+    """The id of the template."""
 
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
+    termination_token: Optional[str] = None
 
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+    turns_counter: Optional[int] = None

letta_client/types/group_count_response.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import TypeAlias
+
+__all__ = ["GroupCountResponse"]
+
+GroupCountResponse: TypeAlias = int

letta_client/types/group_create_params.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+from .dynamic_manager_param import DynamicManagerParam
+from .sleeptime_manager_param import SleeptimeManagerParam
+from .supervisor_manager_param import SupervisorManagerParam
+from .round_robin_manager_param import RoundRobinManagerParam
+from .voice_sleeptime_manager_param import VoiceSleeptimeManagerParam
+
+__all__ = ["GroupCreateParams", "ManagerConfig"]
+
+
+class GroupCreateParams(TypedDict, total=False):
+    agent_ids: Required[SequenceNotStr[str]]
+
+    description: Required[str]
+
+    hidden: Optional[bool]
+    """If set to True, the group will be hidden."""
+
+    manager_config: ManagerConfig
+
+    project_id: Optional[str]
+    """The associated project id."""
+
+    shared_block_ids: SequenceNotStr[str]
+
+    x_project: Annotated[str, PropertyInfo(alias="X-Project")]
+    """The project slug to associate with the group (cloud only)."""
+
+
+ManagerConfig: TypeAlias = Union[
+    RoundRobinManagerParam,
+    SupervisorManagerParam,
+    DynamicManagerParam,
+    SleeptimeManagerParam,
+    VoiceSleeptimeManagerParam,
+]

letta_client/types/group_list_params.py

@@ -0,0 +1,42 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import Literal, TypedDict
+
+from .manager_type import ManagerType
+
+__all__ = ["GroupListParams"]
+
+
+class GroupListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Group ID cursor for pagination.
+
+    Returns groups that come after this group ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Group ID cursor for pagination.
+
+    Returns groups that come before this group ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of groups to return"""
+
+    manager_type: Optional[ManagerType]
+    """Search groups by manager type"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for groups by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""
+
+    project_id: Optional[str]
+    """Search groups by project id"""

letta_client/types/group_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .group import Group
+
+__all__ = ["GroupListResponse"]
+
+GroupListResponse: TypeAlias = List[Group]

letta_client/types/group_update_params.py

@@ -0,0 +1,93 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = [
+    "GroupUpdateParams",
+    "ManagerConfig",
+    "ManagerConfigRoundRobinManagerUpdate",
+    "ManagerConfigSupervisorManagerUpdate",
+    "ManagerConfigDynamicManagerUpdate",
+    "ManagerConfigSleeptimeManagerUpdate",
+    "ManagerConfigVoiceSleeptimeManagerUpdate",
+]
+
+
+class GroupUpdateParams(TypedDict, total=False):
+    agent_ids: Optional[SequenceNotStr[str]]
+
+    description: Optional[str]
+
+    manager_config: Optional[ManagerConfig]
+
+    project_id: Optional[str]
+    """The associated project id."""
+
+    shared_block_ids: Optional[SequenceNotStr[str]]
+
+    x_project: Annotated[str, PropertyInfo(alias="X-Project")]
+    """The project slug to associate with the group (cloud only)."""
+
+
+class ManagerConfigRoundRobinManagerUpdate(TypedDict, total=False):
+    manager_type: Literal["round_robin"]
+
+    max_turns: Optional[int]
+
+
+class ManagerConfigSupervisorManagerUpdate(TypedDict, total=False):
+    manager_agent_id: Required[Optional[str]]
+
+    manager_type: Literal["supervisor"]
+
+
+class ManagerConfigDynamicManagerUpdate(TypedDict, total=False):
+    manager_agent_id: Optional[str]
+
+    manager_type: Literal["dynamic"]
+
+    max_turns: Optional[int]
+
+    termination_token: Optional[str]
+
+
+class ManagerConfigSleeptimeManagerUpdate(TypedDict, total=False):
+    manager_agent_id: Optional[str]
+
+    manager_type: Literal["sleeptime"]
+
+    sleeptime_agent_frequency: Optional[int]
+
+
+class ManagerConfigVoiceSleeptimeManagerUpdate(TypedDict, total=False):
+    manager_agent_id: Optional[str]
+
+    manager_type: Literal["voice_sleeptime"]
+
+    max_message_buffer_length: Optional[int]
+    """The desired maximum length of messages in the context window of the convo agent.
+
+    This is a best effort, and may be off slightly due to user/assistant
+    interleaving.
+    """
+
+    min_message_buffer_length: Optional[int]
+    """The desired minimum length of messages in the context window of the convo agent.
+
+    This is a best effort, and may be off-by-one due to user/assistant interleaving.
+    """
+
+
+ManagerConfig: TypeAlias = Union[
+    ManagerConfigRoundRobinManagerUpdate,
+    ManagerConfigSupervisorManagerUpdate,
+    ManagerConfigDynamicManagerUpdate,
+    ManagerConfigSleeptimeManagerUpdate,
+    ManagerConfigVoiceSleeptimeManagerUpdate,
+]

letta_client/types/groups/__init__.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .message_list_params import MessageListParams as MessageListParams
+from .message_send_params import MessageSendParams as MessageSendParams
+from .message_list_response import MessageListResponse as MessageListResponse
+from .message_stream_params import MessageStreamParams as MessageStreamParams
+from .message_update_params import MessageUpdateParams as MessageUpdateParams
+from .message_update_response import MessageUpdateResponse as MessageUpdateResponse