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

letta_client/types/access_token_create_params.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["AccessTokenCreateParams", "Policy"]
+
+
+class AccessTokenCreateParams(TypedDict, total=False):
+    hostname: Required[str]
+    """The hostname of the client side application.
+
+    Please specify the full URL including the protocol (http or https).
+    """
+
+    policy: Required[Iterable[Policy]]
+
+    expires_at: str
+    """The expiration date of the token.
+
+    If not provided, the token will expire in 5 minutes
+    """
+
+
+class Policy(TypedDict, total=False):
+    id: Required[str]
+
+    access: Required[List[Literal["read_messages", "write_messages", "read_agent", "write_agent"]]]
+
+    type: Required[Literal["agent"]]

letta_client/types/access_token_create_response.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["AccessTokenCreateResponse", "Policy", "PolicyData"]
+
+
+class PolicyData(BaseModel):
+    id: str
+
+    access: List[Literal["read_messages", "write_messages", "read_agent", "write_agent"]]
+
+    type: Literal["agent"]
+
+
+class Policy(BaseModel):
+    data: List[PolicyData]
+
+    version: Literal["1"]
+
+
+class AccessTokenCreateResponse(BaseModel):
+    token: str
+
+    expires_at: str = FieldInfo(alias="expiresAt")
+
+    hostname: str
+
+    policy: Policy

letta_client/types/access_token_delete_params.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["AccessTokenDeleteParams"]
+
+
+class AccessTokenDeleteParams(TypedDict, total=False):
+    body: object

letta_client/types/access_token_list_params.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["AccessTokenListParams"]
+
+
+class AccessTokenListParams(TypedDict, total=False):
+    agent_id: Annotated[str, PropertyInfo(alias="agentId")]
+    """The agent ID to filter tokens by.
+
+    If provided, only tokens for this agent will be returned.
+    """
+
+    limit: float
+    """The number of tokens to return per page. Defaults to 10."""
+
+    offset: float
+    """The offset for pagination. Defaults to 0."""

letta_client/types/access_token_list_response.py

@@ -0,0 +1,40 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["AccessTokenListResponse", "Token", "TokenPolicy", "TokenPolicyData"]
+
+
+class TokenPolicyData(BaseModel):
+    id: str
+
+    access: List[Literal["read_messages", "write_messages", "read_agent", "write_agent"]]
+
+    type: Literal["agent"]
+
+
+class TokenPolicy(BaseModel):
+    data: List[TokenPolicyData]
+
+    version: Literal["1"]
+
+
+class Token(BaseModel):
+    token: str
+
+    expires_at: str = FieldInfo(alias="expiresAt")
+
+    hostname: str
+
+    policy: TokenPolicy
+
+
+class AccessTokenListResponse(BaseModel):
+    has_next_page: bool = FieldInfo(alias="hasNextPage")
+
+    tokens: List[Token]

letta_client/types/agent_create_params.py

@@ -0,0 +1,444 @@
+# 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 typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .._types import SequenceNotStr
+from .agent_type import AgentType
+from .llm_config_param import LlmConfigParam
+from .create_block_param import CreateBlockParam
+from .init_tool_rule_param import InitToolRuleParam
+from .message_create_param import MessageCreateParam
+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__ = [
+    "AgentCreateParams",
+    "CompactionSettings",
+    "CompactionSettingsModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettings",
+    "CompactionSettingsModelSettingsZaiModelSettingsResponseFormat",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettings",
+    "CompactionSettingsModelSettingsChatGptoAuthModelSettingsReasoning",
+    "ModelSettings",
+    "ModelSettingsZaiModelSettings",
+    "ModelSettingsZaiModelSettingsResponseFormat",
+    "ModelSettingsChatGptoAuthModelSettings",
+    "ModelSettingsChatGptoAuthModelSettingsReasoning",
+    "ResponseFormat",
+    "ToolRule",
+]
+
+
+class AgentCreateParams(TypedDict, total=False):
+    agent_type: AgentType
+    """The type of agent."""
+
+    base_template_id: Optional[str]
+    """Deprecated: No longer used. 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_chunk_size: Optional[int]
+    """Deprecated: No longer used. The embedding chunk size used by the agent."""
+
+    embedding_config: Optional[EmbeddingConfigParam]
+    """Configuration for embedding model connection and processing parameters."""
+
+    enable_reasoner: Optional[bool]
+    """Deprecated: Use `model` field to configure reasoning instead.
+
+    Whether to enable internal extended thinking step for a reasoner model.
+    """
+
+    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."""
+
+    from_template: Optional[str]
+    """Deprecated: please use the 'create agents from a template' endpoint instead."""
+
+    hidden: Optional[bool]
+    """Deprecated: No longer used. If set to True, the agent will be hidden."""
+
+    identity_ids: Optional[SequenceNotStr[str]]
+    """The ids of the identities associated with this agent."""
+
+    include_base_tool_rules: Optional[bool]
+    """If true, attaches the Letta base tool rules (e.g.
+
+    deny all tools not explicitly allowed).
+    """
+
+    include_base_tools: bool
+    """If true, attaches the Letta core tools (e.g. core_memory related functions)."""
+
+    include_default_source: bool
+    """
+    If true, automatically creates and attaches a default data source for this
+    agent.
+    """
+
+    include_multi_agent_tools: bool
+    """If true, attaches the Letta multi-agent tools (e.g.
+
+    sending a message to another agent).
+    """
+
+    initial_message_sequence: Optional[Iterable[MessageCreateParam]]
+    """The initial set of messages to put in the agent's in-context memory."""
+
+    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_reasoning_tokens: Optional[int]
+    """Deprecated: Use `model` field to configure reasoning tokens instead.
+
+    The maximum number of tokens to generate for reasoning step.
+    """
+
+    max_tokens: Optional[int]
+    """Deprecated: Use `model` field to configure max output tokens instead.
+
+    The maximum number of tokens to generate, including reasoning step.
+    """
+
+    memory_blocks: Optional[Iterable[CreateBlockParam]]
+    """The blocks to create in the agent's in-context memory."""
+
+    memory_variables: Optional[Dict[str, str]]
+    """Deprecated: Only relevant for creating agents from a template.
+
+    Use the 'create agents from a template' endpoint instead.
+    """
+
+    message_buffer_autoclear: 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.
+    """
+
+    metadata: Optional[Dict[str, object]]
+    """The metadata of the agent."""
+
+    model: Optional[str]
+    """The model handle for the agent to use (format: provider/model-name)."""
+
+    model_settings: Optional[ModelSettings]
+    """The model settings for the agent."""
+
+    name: 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: Optional[str]
+    """
+    Deprecated: Project should now be passed via the X-Project header instead of in
+    the request body. If using the SDK, this can be done via the x_project
+    parameter.
+    """
+
+    project_id: Optional[str]
+    """Deprecated: No longer used. 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: bool
+    """Deprecated: No longer used."""
+
+    template_id: Optional[str]
+    """Deprecated: No longer used. 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.
+
+    Environment variables for tool execution.
+    """
+
+    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."""
+
+    tools: Optional[SequenceNotStr[str]]
+    """The tools used by 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/agent_environment_variable.py

@@ -1,63 +1,40 @@
-# This file was auto-generated by Fern from our API Definition.
-
-from ..core.unchecked_base_model import UncheckedBaseModel
-import typing
-import pydantic
-import datetime as dt
-from ..core.pydantic_utilities import IS_PYDANTIC_V2
-
-
-class AgentEnvironmentVariable(UncheckedBaseModel):
-    created_by_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The id of the user that made this object.
-    """
-
-    last_updated_by_id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The id of the user that made this object.
-    """
-
-    created_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
-    """
-    The timestamp when the object was created.
-    """
-
-    updated_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
-    """
-    The timestamp when the object was last updated.
-    """
-
-    id: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    The human-friendly ID of the Agent-env
-    """
-
-    key: str = pydantic.Field()
-    """
-    The name of the environment variable.
-    """
-
-    value: str = pydantic.Field()
-    """
-    The value of the environment variable.
-    """
-
-    description: typing.Optional[str] = pydantic.Field(default=None)
-    """
-    An optional description of the environment variable.
-    """
-
-    agent_id: str = pydantic.Field()
-    """
-    The ID of the agent this environment variable belongs to.
-    """
-
-    if IS_PYDANTIC_V2:
-        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
-    else:
-
-        class Config:
-            frozen = True
-            smart_union = True
-            extra = pydantic.Extra.allow
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+
+from .._models import BaseModel
+
+__all__ = ["AgentEnvironmentVariable"]
+
+
+class AgentEnvironmentVariable(BaseModel):
+    agent_id: str
+    """The ID of the agent this environment variable belongs to."""
+
+    key: str
+    """The name of the environment variable."""
+
+    value: str
+    """The value of the environment variable."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the Agent-env"""
+
+    created_at: Optional[datetime] = None
+    """The timestamp when the object was created."""
+
+    created_by_id: Optional[str] = None
+    """The id of the user that made this object."""
+
+    description: Optional[str] = None
+    """An optional description of the environment variable."""
+
+    last_updated_by_id: Optional[str] = None
+    """The id of the user that made this object."""
+
+    updated_at: Optional[datetime] = None
+    """The timestamp when the object was last updated."""
+
+    value_enc: Optional[str] = None
+    """Encrypted secret value (stored as encrypted string)"""