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

letta_client/types/agent_type.py

@@ -1,17 +1,17 @@
-# 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_extensions import Literal, TypeAlias
 
-AgentType = typing.Union[
-    typing.Literal[
-        "memgpt_agent",
-        "memgpt_v2_agent",
-        "react_agent",
-        "workflow_agent",
-        "split_thread_agent",
-        "sleeptime_agent",
-        "voice_convo_agent",
-        "voice_sleeptime_agent",
-    ],
-    typing.Any,
+__all__ = ["AgentType"]
+
+AgentType: TypeAlias = Literal[
+    "memgpt_agent",
+    "memgpt_v2_agent",
+    "letta_v1_agent",
+    "react_agent",
+    "workflow_agent",
+    "split_thread_agent",
+    "sleeptime_agent",
+    "voice_convo_agent",
+    "voice_sleeptime_agent",
 ]

letta_client/types/agent_update_params.py

@@ -0,0 +1,386 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Iterable, Optional
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+from .llm_config_param import LlmConfigParam
+from .stop_reason_type import StopReasonType
+from .init_tool_rule_param import InitToolRuleParam
+from .child_tool_rule_param import ChildToolRuleParam
+from .embedding_config_param import EmbeddingConfigParam
+from .parent_tool_rule_param import ParentToolRuleParam
+from .continue_tool_rule_param import ContinueToolRuleParam
+from .terminal_tool_rule_param import TerminalToolRuleParam
+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 .conditional_tool_rule_param import ConditionalToolRuleParam
+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 .requires_approval_tool_rule_param import RequiresApprovalToolRuleParam
+from .google_vertex_model_settings_param import GoogleVertexModelSettingsParam
+from .max_count_per_step_tool_rule_param import MaxCountPerStepToolRuleParam
+from .required_before_exit_tool_rule_param import RequiredBeforeExitToolRuleParam
+
+__all__ = [
+    "AgentUpdateParams",
+    "CompactionSettings",
+    "CompactionSettingsModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettingsResponseFormat",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettings",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettingsReasoning",
+    "ModelSettings",
+    "ModelSettingsZaiModelSettings",
+    "ModelSettingsZaiModelSettingsResponseFormat",
+    "ModelSettingsChatGptoAuthModelSettings",
+    "ModelSettingsChatGptoAuthModelSettingsReasoning",
+    "ResponseFormat",
+    "ToolRule",
+]
+
+
+class AgentUpdateParams(TypedDict, total=False):
+    base_template_id: Optional[str]
+    """The base template id of the agent."""
+
+    block_ids: Optional[SequenceNotStr[str]]
+    """The ids of the blocks used by the agent."""
+
+    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.
+    """
+
+    context_window_limit: Optional[int]
+    """The context window limit used by the agent."""
+
+    description: Optional[str]
+    """The description of the agent."""
+
+    embedding: Optional[str]
+    """The embedding model handle used by the agent (format: provider/model-name)."""
+
+    embedding_config: Optional[EmbeddingConfigParam]
+    """Configuration for embedding model connection and processing parameters."""
+
+    enable_sleeptime: Optional[bool]
+    """If set to True, memory management will move to a background agent thread."""
+
+    folder_ids: Optional[SequenceNotStr[str]]
+    """The ids of the folders used by the agent."""
+
+    hidden: Optional[bool]
+    """If set to True, the agent will be hidden."""
+
+    identity_ids: Optional[SequenceNotStr[str]]
+    """The ids of the identities associated with this agent."""
+
+    last_run_completion: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]
+    """The timestamp when the agent last completed a run."""
+
+    last_run_duration_ms: Optional[int]
+    """The duration in milliseconds of the agent's last run."""
+
+    last_stop_reason: Optional[StopReasonType]
+    """The stop reason from the agent's last run."""
+
+    llm_config: Optional[LlmConfigParam]
+    """Configuration for Language Model (LLM) connection and generation parameters.
+
+    .. deprecated:: LLMConfig is deprecated and should not be used as an input or
+    return type in API calls. Use the schemas in letta.schemas.model (ModelSettings,
+    OpenAIModelSettings, etc.) instead. For conversion, use the \\__to_model() method
+    or Model.\\__from_llm_config() method.
+    """
+
+    max_files_open: Optional[int]
+    """Maximum number of files that can be open at once for this agent.
+
+    Setting this too high may exceed the context window, which will break the agent.
+    """
+
+    max_tokens: Optional[int]
+    """Deprecated: Use `model` field to configure max output tokens instead.
+
+    The maximum number of tokens to generate, including reasoning step.
+    """
+
+    message_buffer_autoclear: Optional[bool]
+    """
+    If set to True, the agent will not remember previous messages (though the agent
+    will still retain state via core memory blocks and archival/recall memory). Not
+    recommended unless you have an advanced use case.
+    """
+
+    message_ids: Optional[SequenceNotStr[str]]
+    """The ids of the messages in the agent's in-context memory."""
+
+    metadata: Optional[Dict[str, object]]
+    """The metadata of the agent."""
+
+    model: Optional[str]
+    """The model handle used by the agent (format: provider/model-name)."""
+
+    model_settings: Optional[ModelSettings]
+    """The model settings for the agent."""
+
+    name: Optional[str]
+    """The name of the agent."""
+
+    parallel_tool_calls: Optional[bool]
+    """Deprecated: Use `model_settings` to configure parallel tool calls instead.
+
+    If set to True, enables parallel tool calling.
+    """
+
+    per_file_view_window_char_limit: Optional[int]
+    """The per-file view window character limit for this agent.
+
+    Setting this too high may exceed the context window, which will break the agent.
+    """
+
+    project_id: Optional[str]
+    """The id of the project the agent belongs to."""
+
+    reasoning: Optional[bool]
+    """Deprecated: Use `model` field to configure reasoning instead.
+
+    Whether to enable reasoning for this agent.
+    """
+
+    response_format: Optional[ResponseFormat]
+    """Deprecated: Use `model_settings` field to configure response format instead.
+
+    The response format for the agent.
+    """
+
+    secrets: Optional[Dict[str, str]]
+    """The environment variables for tool execution specific to this agent."""
+
+    source_ids: Optional[SequenceNotStr[str]]
+    """Deprecated: Use `folder_ids` field instead.
+
+    The ids of the sources used by the agent.
+    """
+
+    system: Optional[str]
+    """The system prompt used by the agent."""
+
+    tags: Optional[SequenceNotStr[str]]
+    """The tags associated with the agent."""
+
+    template_id: Optional[str]
+    """The id of the template the agent belongs to."""
+
+    timezone: Optional[str]
+    """The timezone of the agent (IANA format)."""
+
+    tool_exec_environment_variables: Optional[Dict[str, str]]
+    """Deprecated: use `secrets` field instead"""
+
+    tool_ids: Optional[SequenceNotStr[str]]
+    """The ids of the tools used by the agent."""
+
+    tool_rules: Optional[Iterable[ToolRule]]
+    """The tool rules governing the agent."""
+
+
+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).
+    """
+
+
+ModelSettingsZaiModelSettingsResponseFormat: TypeAlias = Union[
+    TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam
+]
+
+
+class ModelSettingsZaiModelSettings(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[ModelSettingsZaiModelSettingsResponseFormat]
+    """The response format for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+
+class ModelSettingsChatGptoAuthModelSettingsReasoning(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 ModelSettingsChatGptoAuthModelSettings(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: ModelSettingsChatGptoAuthModelSettingsReasoning
+    """The reasoning configuration for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+
+ModelSettings: TypeAlias = Union[
+    OpenAIModelSettingsParam,
+    AnthropicModelSettingsParam,
+    GoogleAIModelSettingsParam,
+    GoogleVertexModelSettingsParam,
+    AzureModelSettingsParam,
+    XaiModelSettingsParam,
+    ModelSettingsZaiModelSettings,
+    GroqModelSettingsParam,
+    DeepseekModelSettingsParam,
+    TogetherModelSettingsParam,
+    BedrockModelSettingsParam,
+    ModelSettingsChatGptoAuthModelSettings,
+]
+
+ResponseFormat: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+ToolRule: TypeAlias = Union[
+    ChildToolRuleParam,
+    InitToolRuleParam,
+    TerminalToolRuleParam,
+    ConditionalToolRuleParam,
+    ContinueToolRuleParam,
+    RequiredBeforeExitToolRuleParam,
+    MaxCountPerStepToolRuleParam,
+    ParentToolRuleParam,
+    RequiresApprovalToolRuleParam,
+]

letta_client/types/agents/__init__.py

@@ -0,0 +1,76 @@
+# 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 .event_message import EventMessage as EventMessage
+from .image_content import ImageContent as ImageContent
+from .letta_response import LettaResponse as LettaResponse
+from .system_message import SystemMessage as SystemMessage
+from .approval_return import ApprovalReturn as ApprovalReturn
+from .summary_message import SummaryMessage as SummaryMessage
+from .tool_call_delta import ToolCallDelta as ToolCallDelta
+from .tool_run_params import ToolRunParams as ToolRunParams
+from .file_list_params import FileListParams as FileListParams
+from .internal_message import InternalMessage as InternalMessage
+from .tool_list_params import ToolListParams as ToolListParams
+from .assistant_message import AssistantMessage as AssistantMessage
+from .block_list_params import BlockListParams as BlockListParams
+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 .block_update_params import BlockUpdateParams as BlockUpdateParams
+from .image_content_param import ImageContentParam as ImageContentParam
+from .message_list_params import MessageListParams as MessageListParams
+from .passage_list_params import PassageListParams as PassageListParams
+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 .approval_return_param import ApprovalReturnParam as ApprovalReturnParam
+from .message_cancel_params import MessageCancelParams as MessageCancelParams
+from .message_create_params import MessageCreateParams as MessageCreateParams
+from .message_stream_params import MessageStreamParams as MessageStreamParams
+from .passage_create_params import PassageCreateParams as PassageCreateParams
+from .passage_list_response import PassageListResponse as PassageListResponse
+from .passage_search_params import PassageSearchParams as PassageSearchParams
+from .tool_execution_result import ToolExecutionResult as ToolExecutionResult
+from .message_compact_params import MessageCompactParams as MessageCompactParams
+from .file_close_all_response import FileCloseAllResponse as FileCloseAllResponse
+from .message_cancel_response import MessageCancelResponse as MessageCancelResponse
+from .passage_create_response import PassageCreateResponse as PassageCreateResponse
+from .passage_search_response import PassageSearchResponse as PassageSearchResponse
+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 .letta_streaming_response import LettaStreamingResponse as LettaStreamingResponse
+from .message_compact_response import MessageCompactResponse as MessageCompactResponse
+from .approval_response_message import ApprovalResponseMessage as ApprovalResponseMessage
+from .omitted_reasoning_content import OmittedReasoningContent as OmittedReasoningContent
+from .tool_return_content_param import ToolReturnContentParam as ToolReturnContentParam
+from .redacted_reasoning_content import RedactedReasoningContent as RedactedReasoningContent
+from .message_create_async_params import MessageCreateAsyncParams as MessageCreateAsyncParams
+from .tool_update_approval_params import ToolUpdateApprovalParams as ToolUpdateApprovalParams
+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,
+)

letta_client/types/agents/approval_create_param.py

@@ -0,0 +1,35 @@
+# 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, TypeAlias, TypedDict
+
+from .tool_return_param import ToolReturnParam
+from .approval_return_param import ApprovalReturnParam
+
+__all__ = ["ApprovalCreateParam", "Approval"]
+
+Approval: TypeAlias = Union[ApprovalReturnParam, ToolReturnParam]
+
+
+class ApprovalCreateParam(TypedDict, total=False):
+    """Input to approve or deny a tool call request"""
+
+    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"""
+
+    group_id: Optional[str]
+    """The multi-agent group that the message was sent in"""
+
+    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,57 @@
+# 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):
+    """
+    A message representing a request for approval to call a tool (generated by the LLM to trigger tool execution).
+
+    Args:
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        name (Optional[str]): The name of the sender of the message
+        tool_call (ToolCall): The tool call
+    """
+
+    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,61 @@
+# 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
+from .approval_return import ApprovalReturn
+
+__all__ = ["ApprovalResponseMessage", "Approval"]
+
+Approval: TypeAlias = Annotated[Union[ApprovalReturn, ToolReturn], PropertyInfo(discriminator="type")]
+
+
+class ApprovalResponseMessage(BaseModel):
+    """
+    A message representing a response form the user indicating whether a tool has been approved to run.
+
+    Args:
+        id (str): The ID of the message
+        date (datetime): The date the message was created in ISO format
+        name (Optional[str]): The name of the sender of the message
+        approve: (bool) Whether the tool has been approved
+        approval_request_id: The ID of the approval request
+        reason: (Optional[str]) An optional explanation for the provided approval status
+    """
+
+    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/approval_return.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["ApprovalReturn"]
+
+
+class ApprovalReturn(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."""