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

letta_client/types/agents/__init__.py

@@ -0,0 +1,78 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .run import Run as Run
+from .block import Block as Block
+from .message import Message as Message
+from .job_type import JobType as JobType
+from .tool_call import ToolCall as ToolCall
+from .job_status import JobStatus as JobStatus
+from .tool_return import ToolReturn as ToolReturn
+from .message_role import MessageRole as MessageRole
+from .message_type import MessageType as MessageType
+from .text_content import TextContent as TextContent
+from .user_message import UserMessage as UserMessage
+from .image_content import ImageContent as ImageContent
+from .letta_response import LettaResponse as LettaResponse
+from .system_message import SystemMessage as SystemMessage
+from .tool_call_delta import ToolCallDelta as ToolCallDelta
+from .file_list_params import FileListParams as FileListParams
+from .tool_list_params import ToolListParams as ToolListParams
+from .assistant_message import AssistantMessage as AssistantMessage
+from .block_list_params import BlockListParams as BlockListParams
+from .group_list_params import GroupListParams as GroupListParams
+from .reasoning_content import ReasoningContent as ReasoningContent
+from .reasoning_message import ReasoningMessage as ReasoningMessage
+from .tool_call_content import ToolCallContent as ToolCallContent
+from .tool_call_message import ToolCallMessage as ToolCallMessage
+from .tool_return_param import ToolReturnParam as ToolReturnParam
+from .file_list_response import FileListResponse as FileListResponse
+from .file_open_response import FileOpenResponse as FileOpenResponse
+from .folder_list_params import FolderListParams as FolderListParams
+from .text_content_param import TextContentParam as TextContentParam
+from .tool_list_response import ToolListResponse as ToolListResponse
+from .block_list_response import BlockListResponse as BlockListResponse
+from .block_update_params import BlockUpdateParams as BlockUpdateParams
+from .group_list_response import GroupListResponse as GroupListResponse
+from .image_content_param import ImageContentParam as ImageContentParam
+from .letta_message_union import LettaMessageUnion as LettaMessageUnion
+from .message_list_params import MessageListParams as MessageListParams
+from .message_send_params import MessageSendParams as MessageSendParams
+from .tool_return_content import ToolReturnContent as ToolReturnContent
+from .folder_list_response import FolderListResponse as FolderListResponse
+from .message_reset_params import MessageResetParams as MessageResetParams
+from .approval_create_param import ApprovalCreateParam as ApprovalCreateParam
+from .message_cancel_params import MessageCancelParams as MessageCancelParams
+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 .file_close_all_response import FileCloseAllResponse as FileCloseAllResponse
+from .message_cancel_response import MessageCancelResponse as MessageCancelResponse
+from .message_update_response import MessageUpdateResponse as MessageUpdateResponse
+from .reasoning_content_param import ReasoningContentParam as ReasoningContentParam
+from .tool_call_content_param import ToolCallContentParam as ToolCallContentParam
+from .approval_request_message import ApprovalRequestMessage as ApprovalRequestMessage
+from .hidden_reasoning_message import HiddenReasoningMessage as HiddenReasoningMessage
+from .approval_response_message import ApprovalResponseMessage as ApprovalResponseMessage
+from .message_send_async_params import MessageSendAsyncParams as MessageSendAsyncParams
+from .omitted_reasoning_content import OmittedReasoningContent as OmittedReasoningContent
+from .tool_return_content_param import ToolReturnContentParam as ToolReturnContentParam
+from .update_user_message_param import UpdateUserMessageParam as UpdateUserMessageParam
+from .redacted_reasoning_content import RedactedReasoningContent as RedactedReasoningContent
+from .tool_update_approval_params import ToolUpdateApprovalParams as ToolUpdateApprovalParams
+from .update_system_message_param import UpdateSystemMessageParam as UpdateSystemMessageParam
+from .update_assistant_message_param import UpdateAssistantMessageParam as UpdateAssistantMessageParam
+from .update_reasoning_message_param import UpdateReasoningMessageParam as UpdateReasoningMessageParam
+from .omitted_reasoning_content_param import OmittedReasoningContentParam as OmittedReasoningContentParam
+from .letta_user_message_content_union import LettaUserMessageContentUnion as LettaUserMessageContentUnion
+from .redacted_reasoning_content_param import RedactedReasoningContentParam as RedactedReasoningContentParam
+from .letta_assistant_message_content_union import (
+    LettaAssistantMessageContentUnion as LettaAssistantMessageContentUnion,
+)
+from .letta_user_message_content_union_param import (
+    LettaUserMessageContentUnionParam as LettaUserMessageContentUnionParam,
+)
+from .letta_assistant_message_content_union_param import (
+    LettaAssistantMessageContentUnionParam as LettaAssistantMessageContentUnionParam,
+)

letta_client/types/agents/approval_create_param.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, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .tool_return_param import ToolReturnParam
+
+__all__ = ["ApprovalCreateParam", "Approval", "ApprovalApprovalReturn"]
+
+
+class ApprovalApprovalReturn(TypedDict, total=False):
+    approve: Required[bool]
+    """Whether the tool has been approved"""
+
+    tool_call_id: Required[str]
+    """The ID of the tool call that corresponds to this approval"""
+
+    reason: Optional[str]
+    """An optional explanation for the provided approval status"""
+
+    type: Literal["approval"]
+    """The message type to be created."""
+
+
+Approval: TypeAlias = Union[ApprovalApprovalReturn, ToolReturnParam]
+
+
+class ApprovalCreateParam(TypedDict, total=False):
+    approval_request_id: Optional[str]
+    """The message ID of the approval request"""
+
+    approvals: Optional[Iterable[Approval]]
+    """The list of approval responses"""
+
+    approve: Optional[bool]
+    """Whether the tool has been approved"""
+
+    reason: Optional[str]
+    """An optional explanation for the provided approval status"""
+
+    type: Literal["approval"]
+    """The message type to be created."""

letta_client/types/agents/approval_request_message.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, TypeAlias
+
+from . import tool_call
+from ..._models import BaseModel
+from .tool_call_delta import ToolCallDelta
+
+__all__ = ["ApprovalRequestMessage", "ToolCall", "ToolCalls"]
+
+ToolCall: TypeAlias = Union[tool_call.ToolCall, ToolCallDelta]
+
+ToolCalls: TypeAlias = Union[List[tool_call.ToolCall], ToolCallDelta, None]
+
+
+class ApprovalRequestMessage(BaseModel):
+    id: str
+
+    date: datetime
+
+    tool_call: ToolCall
+    """The tool call that has been requested by the llm to run"""
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["approval_request_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None
+
+    tool_calls: Optional[ToolCalls] = None
+    """
+    The tool calls that have been requested by the llm to run, which are pending
+    approval
+    """

letta_client/types/agents/approval_response_message.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+from .tool_return import ToolReturn
+
+__all__ = ["ApprovalResponseMessage", "Approval", "ApprovalApprovalReturn"]
+
+
+class ApprovalApprovalReturn(BaseModel):
+    approve: bool
+    """Whether the tool has been approved"""
+
+    tool_call_id: str
+    """The ID of the tool call that corresponds to this approval"""
+
+    reason: Optional[str] = None
+    """An optional explanation for the provided approval status"""
+
+    type: Optional[Literal["approval"]] = None
+    """The message type to be created."""
+
+
+Approval: TypeAlias = Annotated[Union[ApprovalApprovalReturn, ToolReturn], PropertyInfo(discriminator="type")]
+
+
+class ApprovalResponseMessage(BaseModel):
+    id: str
+
+    date: datetime
+
+    approval_request_id: Optional[str] = None
+    """The message ID of the approval request"""
+
+    approvals: Optional[List[Approval]] = None
+    """The list of approval responses"""
+
+    approve: Optional[bool] = None
+    """Whether the tool has been approved"""
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["approval_response_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    reason: Optional[str] = None
+    """An optional explanation for the provided approval status"""
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None

letta_client/types/agents/assistant_message.py

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .letta_assistant_message_content_union import LettaAssistantMessageContentUnion
+
+__all__ = ["AssistantMessage"]
+
+
+class AssistantMessage(BaseModel):
+    id: str
+
+    content: Union[List[LettaAssistantMessageContentUnion], str]
+    """
+    The message content sent by the agent (can be a string or an array of content
+    parts)
+    """
+
+    date: datetime
+
+    is_err: Optional[bool] = None
+
+    message_type: Optional[Literal["assistant_message"]] = None
+    """The type of the message."""
+
+    name: Optional[str] = None
+
+    otid: Optional[str] = None
+
+    run_id: Optional[str] = None
+
+    sender_id: Optional[str] = None
+
+    seq_id: Optional[int] = None
+
+    step_id: Optional[str] = None

letta_client/types/agents/block.py

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+
+from ..._models import BaseModel
+
+__all__ = ["Block"]
+
+
+class Block(BaseModel):
+    value: str
+    """Value of the block."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the Block"""
+
+    base_template_id: Optional[str] = None
+    """The base template id of the block."""
+
+    created_by_id: Optional[str] = None
+    """The id of the user that made this Block."""
+
+    deployment_id: Optional[str] = None
+    """The id of the deployment."""
+
+    description: Optional[str] = None
+    """Description of the block."""
+
+    entity_id: Optional[str] = None
+    """The id of the entity within the template."""
+
+    hidden: Optional[bool] = None
+    """If set to True, the block will be hidden."""
+
+    is_template: Optional[bool] = None
+    """Whether the block is a template (e.g. saved human/persona options)."""
+
+    label: Optional[str] = None
+    """Label of the block (e.g. 'human', 'persona') in the context window."""
+
+    last_updated_by_id: Optional[str] = None
+    """The id of the user that last updated this Block."""
+
+    limit: Optional[int] = None
+    """Character limit of the block."""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Metadata of the block."""
+
+    name: Optional[str] = None
+    """The id of the template."""
+
+    preserve_on_migration: Optional[bool] = None
+    """Preserve the block on template migration."""
+
+    project_id: Optional[str] = None
+    """The associated project id."""
+
+    read_only: Optional[bool] = None
+    """Whether the agent has read-only access to the block."""

letta_client/types/agents/block_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__ = ["BlockListParams"]
+
+
+class BlockListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Block ID cursor for pagination.
+
+    Returns blocks that come after this block ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Block ID cursor for pagination.
+
+    Returns blocks that come before this block ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of blocks to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for blocks by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/agents/block_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 .block import Block
+
+__all__ = ["BlockListResponse"]
+
+BlockListResponse: TypeAlias = List[Block]

letta_client/types/agents/block_update_params.py

@@ -0,0 +1,55 @@
+# 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 Required, TypedDict
+
+__all__ = ["BlockUpdateParams"]
+
+
+class BlockUpdateParams(TypedDict, total=False):
+    agent_id: Required[str]
+    """The ID of the agent in the format 'agent-<uuid4>'"""
+
+    base_template_id: Optional[str]
+    """The base template id of the block."""
+
+    deployment_id: Optional[str]
+    """The id of the deployment."""
+
+    description: Optional[str]
+    """Description of the block."""
+
+    entity_id: Optional[str]
+    """The id of the entity within the template."""
+
+    hidden: Optional[bool]
+    """If set to True, the block will be hidden."""
+
+    is_template: bool
+    """Whether the block is a template (e.g. saved human/persona options)."""
+
+    label: Optional[str]
+    """Label of the block (e.g. 'human', 'persona') in the context window."""
+
+    limit: Optional[int]
+    """Character limit of the block."""
+
+    metadata: Optional[Dict[str, object]]
+    """Metadata of the block."""
+
+    name: Optional[str]
+    """The id of the template."""
+
+    preserve_on_migration: Optional[bool]
+    """Preserve the block on template migration."""
+
+    project_id: Optional[str]
+    """The associated project id."""
+
+    read_only: bool
+    """Whether the agent has read-only access to the block."""
+
+    value: Optional[str]
+    """Value of the block."""

letta_client/types/agents/file_close_all_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__ = ["FileCloseAllResponse"]
+
+FileCloseAllResponse: TypeAlias = List[str]

letta_client/types/agents/file_list_params.py

@@ -0,0 +1,40 @@
+# 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
+    """
+
+    cursor: Optional[str]
+    """Pagination cursor from previous response (deprecated, use before/after)"""
+
+    is_open: Optional[bool]
+    """Filter by open status (true for open files, false for closed files)"""
+
+    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/agents/file_list_response.py

@@ -0,0 +1,51 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from ..._models import BaseModel
+
+__all__ = ["FileListResponse", "File"]
+
+
+class File(BaseModel):
+    id: str
+    """Unique identifier of the file-agent relationship"""
+
+    file_id: str
+    """Unique identifier of the file"""
+
+    file_name: str
+    """Name of the file"""
+
+    folder_id: str
+    """Unique identifier of the folder/source"""
+
+    folder_name: str
+    """Name of the folder/source"""
+
+    is_open: bool
+    """Whether the file is currently open in the agent's context"""
+
+    end_line: Optional[int] = None
+    """Ending line number if file was opened with line range"""
+
+    last_accessed_at: Optional[datetime] = None
+    """Timestamp of last access by the agent"""
+
+    start_line: Optional[int] = None
+    """Starting line number if file was opened with line range"""
+
+    visible_content: Optional[str] = None
+    """Portion of the file visible to the agent if open"""
+
+
+class FileListResponse(BaseModel):
+    files: List[File]
+    """List of file attachments for the agent"""
+
+    has_more: bool
+    """Whether more results exist after this page"""
+
+    next_cursor: Optional[str] = None
+    """Cursor for fetching the next page (file-agent relationship ID)"""

letta_client/types/agents/file_open_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__ = ["FileOpenResponse"]
+
+FileOpenResponse: TypeAlias = List[str]

letta_client/types/agents/folder_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__ = ["FolderListParams"]
+
+
+class FolderListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Source ID cursor for pagination.
+
+    Returns sources that come after this source ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Source ID cursor for pagination.
+
+    Returns sources that come before this source ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of sources to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for sources by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/agents/folder_list_response.py

@@ -0,0 +1,49 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from datetime import datetime
+from typing_extensions import TypeAlias
+
+from ..._models import BaseModel
+from ..embedding_config import EmbeddingConfig
+from ..vector_db_provider import VectorDBProvider
+
+__all__ = ["FolderListResponse", "FolderListResponseItem"]
+
+
+class FolderListResponseItem(BaseModel):
+    embedding_config: EmbeddingConfig
+    """The embedding configuration used by the source."""
+
+    name: str
+    """The name of the source."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the Source"""
+
+    created_at: Optional[datetime] = None
+    """The timestamp when the source was created."""
+
+    created_by_id: Optional[str] = None
+    """The id of the user that made this Tool."""
+
+    description: Optional[str] = None
+    """The description of the source."""
+
+    instructions: Optional[str] = None
+    """Instructions for how to use the source."""
+
+    last_updated_by_id: Optional[str] = None
+    """The id of the user that made this Tool."""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Metadata associated with the source."""
+
+    updated_at: Optional[datetime] = None
+    """The timestamp when the source was last updated."""
+
+    vector_db_provider: Optional[VectorDBProvider] = None
+    """The vector database provider used for this source's passages"""
+
+
+FolderListResponse: TypeAlias = List[FolderListResponseItem]

letta_client/types/agents/group_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__ = ["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[str]
+    """Manager type to filter groups by"""
+
+    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"""