letta-client 0.1.226__py3-none-any.whl → 1.7.2__py3-none-any.whl

letta_client/types/agents/message_compact_params.py

@@ -0,0 +1,145 @@
+# 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, TypeAlias, TypedDict
+
+from ..xai_model_settings_param import XaiModelSettingsParam
+from ..groq_model_settings_param import GroqModelSettingsParam
+from ..azure_model_settings_param import AzureModelSettingsParam
+from ..text_response_format_param import TextResponseFormatParam
+from ..openai_model_settings_param import OpenAIModelSettingsParam
+from ..bedrock_model_settings_param import BedrockModelSettingsParam
+from ..deepseek_model_settings_param import DeepseekModelSettingsParam
+from ..together_model_settings_param import TogetherModelSettingsParam
+from ..anthropic_model_settings_param import AnthropicModelSettingsParam
+from ..google_ai_model_settings_param import GoogleAIModelSettingsParam
+from ..json_object_response_format_param import JsonObjectResponseFormatParam
+from ..json_schema_response_format_param import JsonSchemaResponseFormatParam
+from ..google_vertex_model_settings_param import GoogleVertexModelSettingsParam
+
+__all__ = [
+    "MessageCompactParams",
+    "CompactionSettings",
+    "CompactionSettingsModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettingsResponseFormat",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettings",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettingsReasoning",
+]
+
+
+class MessageCompactParams(TypedDict, total=False):
+    compaction_settings: Optional[CompactionSettings]
+    """Configuration for conversation compaction / summarization.
+
+    `model` is the only required user-facing field – it specifies the summarizer
+    model handle (e.g. `"openai/gpt-4o-mini"`). Per-model settings (temperature, max
+    tokens, etc.) are derived from the default configuration for that handle.
+    """
+
+
+CompactionSettingsModelSettingsZaiModelSettingsResponseFormat: TypeAlias = Union[
+    TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam
+]
+
+
+class CompactionSettingsModelSettingsZaiModelSettings(TypedDict, total=False):
+    """Z.ai (ZhipuAI) model configuration (OpenAI-compatible)."""
+
+    max_output_tokens: int
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: bool
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Literal["zai"]
+    """The type of the provider."""
+
+    response_format: Optional[CompactionSettingsModelSettingsZaiModelSettingsResponseFormat]
+    """The response format for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+
+class CompactionSettingsModelSettingsChatGptoAuthModelSettingsReasoning(TypedDict, total=False):
+    """The reasoning configuration for the model."""
+
+    reasoning_effort: Literal["none", "low", "medium", "high", "xhigh"]
+    """The reasoning effort level for GPT-5.x and o-series models."""
+
+
+class CompactionSettingsModelSettingsChatGptoAuthModelSettings(TypedDict, total=False):
+    """ChatGPT OAuth model configuration (uses ChatGPT backend API)."""
+
+    max_output_tokens: int
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: bool
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Literal["chatgpt_oauth"]
+    """The type of the provider."""
+
+    reasoning: CompactionSettingsModelSettingsChatGptoAuthModelSettingsReasoning
+    """The reasoning configuration for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+
+CompactionSettingsModelSettings: TypeAlias = Union[
+    OpenAIModelSettingsParam,
+    AnthropicModelSettingsParam,
+    GoogleAIModelSettingsParam,
+    GoogleVertexModelSettingsParam,
+    AzureModelSettingsParam,
+    XaiModelSettingsParam,
+    CompactionSettingsModelSettingsZaiModelSettings,
+    GroqModelSettingsParam,
+    DeepseekModelSettingsParam,
+    TogetherModelSettingsParam,
+    BedrockModelSettingsParam,
+    CompactionSettingsModelSettingsChatGptoAuthModelSettings,
+]
+
+
+class CompactionSettings(TypedDict, total=False):
+    """Configuration for conversation compaction / summarization.
+
+    ``model`` is the only required user-facing field – it specifies the summarizer
+    model handle (e.g. ``"openai/gpt-4o-mini"``). Per-model settings (temperature,
+    max tokens, etc.) are derived from the default configuration for that handle.
+    """
+
+    model: Required[str]
+    """Model handle to use for summarization (format: provider/model-name)."""
+
+    clip_chars: Optional[int]
+    """The maximum length of the summary in characters.
+
+    If none, no clipping is performed.
+    """
+
+    mode: Literal["all", "sliding_window"]
+    """The type of summarization technique use."""
+
+    model_settings: Optional[CompactionSettingsModelSettings]
+    """Optional model settings used to override defaults for the summarizer model."""
+
+    prompt: str
+    """The prompt to use for summarization."""
+
+    prompt_acknowledgement: bool
+    """
+    Whether to include an acknowledgement post-prompt (helps prevent non-summary
+    outputs).
+    """
+
+    sliding_window_percentage: float
+    """
+    The percentage of the context window to keep post-summarization (only used in
+    sliding window mode).
+    """

letta_client/types/agents/message_compact_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["MessageCompactResponse"]
+
+
+class MessageCompactResponse(BaseModel):
+    num_messages_after: int
+
+    num_messages_before: int
+
+    summary: str

letta_client/types/agents/message_create_async_params.py

@@ -0,0 +1,145 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .message_type import MessageType
+from .text_content_param import TextContentParam
+from .image_content_param import ImageContentParam
+from ..message_create_param import MessageCreateParam
+from .approval_create_param import ApprovalCreateParam
+from .reasoning_content_param import ReasoningContentParam
+from .tool_call_content_param import ToolCallContentParam
+from .tool_return_content_param import ToolReturnContentParam
+from .omitted_reasoning_content_param import OmittedReasoningContentParam
+from .redacted_reasoning_content_param import RedactedReasoningContentParam
+
+__all__ = [
+    "MessageCreateAsyncParams",
+    "ClientTool",
+    "InputUnionMember1",
+    "InputUnionMember1SummarizedReasoningContent",
+    "InputUnionMember1SummarizedReasoningContentSummary",
+    "Message",
+]
+
+
+class MessageCreateAsyncParams(TypedDict, total=False):
+    assistant_message_tool_kwarg: str
+    """The name of the message argument in the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
+
+    assistant_message_tool_name: str
+    """The name of the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
+
+    callback_url: Optional[str]
+    """Optional callback URL to POST to when the job completes"""
+
+    client_tools: Optional[Iterable[ClientTool]]
+    """Client-side tools that the agent can call.
+
+    When the agent calls a client-side tool, execution pauses and returns control to
+    the client to execute the tool and provide the result via a ToolReturn.
+    """
+
+    enable_thinking: str
+    """
+    If set to True, enables reasoning before responses or tool calls from the agent.
+    """
+
+    include_return_message_types: Optional[List[MessageType]]
+    """Only return specified message types in the response.
+
+    If `None` (default) returns all messages.
+    """
+
+    input: Union[str, Iterable[InputUnionMember1], None]
+    """Syntactic sugar for a single user message.
+
+    Equivalent to messages=[{'role': 'user', 'content': input}].
+    """
+
+    max_steps: int
+    """Maximum number of steps the agent should take to process the request."""
+
+    messages: Optional[Iterable[Message]]
+    """The messages to be sent to the agent."""
+
+    override_model: Optional[str]
+    """Model handle to use for this request instead of the agent's default model.
+
+    This allows sending a message to a different model without changing the agent's
+    configuration.
+    """
+
+    use_assistant_message: bool
+    """
+    Whether the server should parse specific tool call arguments (default
+    `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+    types, but deprecated for letta_v1_agent onward.
+    """
+
+
+class ClientTool(TypedDict, total=False):
+    """Schema for a client-side tool passed in the request.
+
+    Client-side tools are executed by the client, not the server. When the agent
+    calls a client-side tool, execution pauses and returns control to the client
+    to execute the tool and provide the result.
+    """
+
+    name: Required[str]
+    """The name of the tool function"""
+
+    description: Optional[str]
+    """Description of what the tool does"""
+
+    parameters: Optional[Dict[str, object]]
+    """JSON Schema for the function parameters"""
+
+
+class InputUnionMember1SummarizedReasoningContentSummary(TypedDict, total=False):
+    index: Required[int]
+    """The index of the summary part."""
+
+    text: Required[str]
+    """The text of the summary part."""
+
+
+class InputUnionMember1SummarizedReasoningContent(TypedDict, total=False):
+    """The style of reasoning content returned by the OpenAI Responses API"""
+
+    id: Required[str]
+    """The unique identifier for this reasoning step."""
+
+    summary: Required[Iterable[InputUnionMember1SummarizedReasoningContentSummary]]
+    """Summaries of the reasoning content."""
+
+    encrypted_content: str
+    """The encrypted reasoning content."""
+
+    type: Literal["summarized_reasoning"]
+    """Indicates this is a summarized reasoning step."""
+
+
+InputUnionMember1: TypeAlias = Union[
+    TextContentParam,
+    ImageContentParam,
+    ToolCallContentParam,
+    ToolReturnContentParam,
+    ReasoningContentParam,
+    RedactedReasoningContentParam,
+    OmittedReasoningContentParam,
+    InputUnionMember1SummarizedReasoningContent,
+]
+
+Message: TypeAlias = Union[MessageCreateParam, ApprovalCreateParam]

letta_client/types/agents/message_create_params.py

@@ -0,0 +1,181 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Union, Iterable, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .message_type import MessageType
+from .text_content_param import TextContentParam
+from .image_content_param import ImageContentParam
+from ..message_create_param import MessageCreateParam
+from .approval_create_param import ApprovalCreateParam
+from .reasoning_content_param import ReasoningContentParam
+from .tool_call_content_param import ToolCallContentParam
+from .tool_return_content_param import ToolReturnContentParam
+from .omitted_reasoning_content_param import OmittedReasoningContentParam
+from .redacted_reasoning_content_param import RedactedReasoningContentParam
+
+__all__ = [
+    "MessageCreateParamsBase",
+    "ClientTool",
+    "InputUnionMember1",
+    "InputUnionMember1SummarizedReasoningContent",
+    "InputUnionMember1SummarizedReasoningContentSummary",
+    "Message",
+    "MessageCreateParamsNonStreaming",
+    "MessageCreateParamsStreaming",
+]
+
+
+class MessageCreateParamsBase(TypedDict, total=False):
+    assistant_message_tool_kwarg: str
+    """The name of the message argument in the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
+
+    assistant_message_tool_name: str
+    """The name of the designated message tool.
+
+    Still supported for legacy agent types, but deprecated for letta_v1_agent
+    onward.
+    """
+
+    background: bool
+    """
+    Whether to process the request in the background (only used when
+    streaming=true).
+    """
+
+    client_tools: Optional[Iterable[ClientTool]]
+    """Client-side tools that the agent can call.
+
+    When the agent calls a client-side tool, execution pauses and returns control to
+    the client to execute the tool and provide the result via a ToolReturn.
+    """
+
+    enable_thinking: str
+    """
+    If set to True, enables reasoning before responses or tool calls from the agent.
+    """
+
+    include_pings: bool
+    """
+    Whether to include periodic keepalive ping messages in the stream to prevent
+    connection timeouts (only used when streaming=true).
+    """
+
+    include_return_message_types: Optional[List[MessageType]]
+    """Only return specified message types in the response.
+
+    If `None` (default) returns all messages.
+    """
+
+    input: Union[str, Iterable[InputUnionMember1], None]
+    """Syntactic sugar for a single user message.
+
+    Equivalent to messages=[{'role': 'user', 'content': input}].
+    """
+
+    max_steps: int
+    """Maximum number of steps the agent should take to process the request."""
+
+    messages: Optional[Iterable[Message]]
+    """The messages to be sent to the agent."""
+
+    override_model: Optional[str]
+    """Model handle to use for this request instead of the agent's default model.
+
+    This allows sending a message to a different model without changing the agent's
+    configuration.
+    """
+
+    stream_tokens: bool
+    """
+    Flag to determine if individual tokens should be streamed, rather than streaming
+    per step (only used when streaming=true).
+    """
+
+    use_assistant_message: bool
+    """
+    Whether the server should parse specific tool call arguments (default
+    `send_message`) as `AssistantMessage` objects. Still supported for legacy agent
+    types, but deprecated for letta_v1_agent onward.
+    """
+
+
+class ClientTool(TypedDict, total=False):
+    """Schema for a client-side tool passed in the request.
+
+    Client-side tools are executed by the client, not the server. When the agent
+    calls a client-side tool, execution pauses and returns control to the client
+    to execute the tool and provide the result.
+    """
+
+    name: Required[str]
+    """The name of the tool function"""
+
+    description: Optional[str]
+    """Description of what the tool does"""
+
+    parameters: Optional[Dict[str, object]]
+    """JSON Schema for the function parameters"""
+
+
+class InputUnionMember1SummarizedReasoningContentSummary(TypedDict, total=False):
+    index: Required[int]
+    """The index of the summary part."""
+
+    text: Required[str]
+    """The text of the summary part."""
+
+
+class InputUnionMember1SummarizedReasoningContent(TypedDict, total=False):
+    """The style of reasoning content returned by the OpenAI Responses API"""
+
+    id: Required[str]
+    """The unique identifier for this reasoning step."""
+
+    summary: Required[Iterable[InputUnionMember1SummarizedReasoningContentSummary]]
+    """Summaries of the reasoning content."""
+
+    encrypted_content: str
+    """The encrypted reasoning content."""
+
+    type: Literal["summarized_reasoning"]
+    """Indicates this is a summarized reasoning step."""
+
+
+InputUnionMember1: TypeAlias = Union[
+    TextContentParam,
+    ImageContentParam,
+    ToolCallContentParam,
+    ToolReturnContentParam,
+    ReasoningContentParam,
+    RedactedReasoningContentParam,
+    OmittedReasoningContentParam,
+    InputUnionMember1SummarizedReasoningContent,
+]
+
+Message: TypeAlias = Union[MessageCreateParam, ApprovalCreateParam]
+
+
+class MessageCreateParamsNonStreaming(MessageCreateParamsBase, total=False):
+    streaming: Literal[False]
+    """If True, returns a streaming response (Server-Sent Events).
+
+    If False (default), returns a complete response.
+    """
+
+
+class MessageCreateParamsStreaming(MessageCreateParamsBase):
+    streaming: Required[Literal[True]]
+    """If True, returns a streaming response (Server-Sent Events).
+
+    If False (default), returns a complete response.
+    """
+
+
+MessageCreateParams = Union[MessageCreateParamsNonStreaming, MessageCreateParamsStreaming]

letta_client/types/agents/message_list_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 Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["MessageListParams"]
+
+
+class MessageListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come after this message ID in the specified sort order
+    """
+
+    assistant_message_tool_kwarg: str
+    """The name of the message argument."""
+
+    assistant_message_tool_name: str
+    """The name of the designated message tool."""
+
+    before: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come before this message ID in the specified sort order
+    """
+
+    conversation_id: Optional[str]
+    """Conversation ID to filter messages by."""
+
+    group_id: Optional[str]
+    """Group ID to filter messages by."""
+
+    include_err: Optional[bool]
+    """Whether to include error messages and error statuses.
+
+    For debugging purposes only.
+    """
+
+    limit: Optional[int]
+    """Maximum number of messages to return"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for messages by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""
+
+    use_assistant_message: bool
+    """Whether to use assistant messages"""

letta_client/types/agents/message_reset_params.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["MessageResetParams"]
+
+
+class MessageResetParams(TypedDict, total=False):
+    add_default_initial_messages: bool
+    """If true, adds the default initial messages after resetting."""

letta_client/types/agents/message_role.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["MessageRole"]
+
+MessageRole: TypeAlias = Literal["assistant", "user", "tool", "function", "system", "approval"]