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

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,12 @@
+# 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_retrieve_params import FileRetrieveParams as FileRetrieveParams
+from .file_upload_response import FileUploadResponse as FileUploadResponse
+from .file_retrieve_response import FileRetrieveResponse as FileRetrieveResponse

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,70 @@
+# 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__ = ["FileListResponse"]
+
+
+class FileListResponse(BaseModel):
+    """Representation of a single FileMetadata"""
+
+    id: str
+    """The human-friendly ID of the File"""
+
+    source_id: str
+    """Deprecated: Use `folder_id` field instead.
+
+    The unique identifier of the source associated with the document.
+    """
+
+    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/folders/file_retrieve_params.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["FileRetrieveParams"]
+
+
+class FileRetrieveParams(TypedDict, total=False):
+    folder_id: Required[str]
+    """The ID of the source in the format 'source-<uuid4>'"""
+
+    include_content: bool
+    """Whether to include full file content"""

letta_client/types/folders/file_retrieve_response.py

@@ -0,0 +1,70 @@
+# 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__ = ["FileRetrieveResponse"]
+
+
+class FileRetrieveResponse(BaseModel):
+    """Representation of a single FileMetadata"""
+
+    id: str
+    """The human-friendly ID of the File"""
+
+    source_id: str
+    """Deprecated: Use `folder_id` field instead.
+
+    The unique identifier of the source associated with the document.
+    """
+
+    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/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,70 @@
+# 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):
+    """Representation of a single FileMetadata"""
+
+    id: str
+    """The human-friendly ID of the File"""
+
+    source_id: str
+    """Deprecated: Use `folder_id` field instead.
+
+    The unique identifier of the source associated with the document.
+    """
+
+    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/google_ai_model_settings.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .text_response_format import TextResponseFormat
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+
+__all__ = ["GoogleAIModelSettings", "ResponseSchema", "ThinkingConfig"]
+
+ResponseSchema: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ThinkingConfig(BaseModel):
+    """The thinking configuration for the model."""
+
+    include_thoughts: Optional[bool] = None
+    """Whether to include thoughts in the model's response."""
+
+    thinking_budget: Optional[int] = None
+    """The thinking budget for the model."""
+
+
+class GoogleAIModelSettings(BaseModel):
+    max_output_tokens: Optional[int] = None
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: Optional[bool] = None
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Optional[Literal["google_ai"]] = None
+    """The type of the provider."""
+
+    response_schema: Optional[ResponseSchema] = None
+    """The response schema for the model."""
+
+    temperature: Optional[float] = None
+    """The temperature of the model."""
+
+    thinking_config: Optional[ThinkingConfig] = None
+    """The thinking configuration for the model."""

letta_client/types/google_ai_model_settings_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, Optional
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+from .text_response_format_param import TextResponseFormatParam
+from .json_object_response_format_param import JsonObjectResponseFormatParam
+from .json_schema_response_format_param import JsonSchemaResponseFormatParam
+
+__all__ = ["GoogleAIModelSettingsParam", "ResponseSchema", "ThinkingConfig"]
+
+ResponseSchema: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class ThinkingConfig(TypedDict, total=False):
+    """The thinking configuration for the model."""
+
+    include_thoughts: bool
+    """Whether to include thoughts in the model's response."""
+
+    thinking_budget: int
+    """The thinking budget for the model."""
+
+
+class GoogleAIModelSettingsParam(TypedDict, total=False):
+    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["google_ai"]
+    """The type of the provider."""
+
+    response_schema: Optional[ResponseSchema]
+    """The response schema for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+    thinking_config: ThinkingConfig
+    """The thinking configuration for the model."""

letta_client/types/google_vertex_model_settings.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .text_response_format import TextResponseFormat
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+
+__all__ = ["GoogleVertexModelSettings", "ResponseSchema", "ThinkingConfig"]
+
+ResponseSchema: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ThinkingConfig(BaseModel):
+    """The thinking configuration for the model."""
+
+    include_thoughts: Optional[bool] = None
+    """Whether to include thoughts in the model's response."""
+
+    thinking_budget: Optional[int] = None
+    """The thinking budget for the model."""
+
+
+class GoogleVertexModelSettings(BaseModel):
+    max_output_tokens: Optional[int] = None
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: Optional[bool] = None
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Optional[Literal["google_vertex"]] = None
+    """The type of the provider."""
+
+    response_schema: Optional[ResponseSchema] = None
+    """The response schema for the model."""
+
+    temperature: Optional[float] = None
+    """The temperature of the model."""
+
+    thinking_config: Optional[ThinkingConfig] = None
+    """The thinking configuration for the model."""

letta_client/types/google_vertex_model_settings_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, Optional
+from typing_extensions import Literal, TypeAlias, TypedDict
+
+from .text_response_format_param import TextResponseFormatParam
+from .json_object_response_format_param import JsonObjectResponseFormatParam
+from .json_schema_response_format_param import JsonSchemaResponseFormatParam
+
+__all__ = ["GoogleVertexModelSettingsParam", "ResponseSchema", "ThinkingConfig"]
+
+ResponseSchema: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class ThinkingConfig(TypedDict, total=False):
+    """The thinking configuration for the model."""
+
+    include_thoughts: bool
+    """Whether to include thoughts in the model's response."""
+
+    thinking_budget: int
+    """The thinking budget for the model."""
+
+
+class GoogleVertexModelSettingsParam(TypedDict, total=False):
+    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["google_vertex"]
+    """The type of the provider."""
+
+    response_schema: Optional[ResponseSchema]
+    """The response schema for the model."""
+
+    temperature: float
+    """The temperature of the model."""
+
+    thinking_config: ThinkingConfig
+    """The thinking configuration for the model."""

letta_client/types/groq_model_settings.py

@@ -0,0 +1,36 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .._models import BaseModel
+from .text_response_format import TextResponseFormat
+from .json_object_response_format import JsonObjectResponseFormat
+from .json_schema_response_format import JsonSchemaResponseFormat
+
+__all__ = ["GroqModelSettings", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class GroqModelSettings(BaseModel):
+    """Groq model configuration (OpenAI-compatible)."""
+
+    max_output_tokens: Optional[int] = None
+    """The maximum number of tokens the model can generate."""
+
+    parallel_tool_calls: Optional[bool] = None
+    """Whether to enable parallel tool calling."""
+
+    provider_type: Optional[Literal["groq"]] = None
+    """The type of the provider."""
+
+    response_format: Optional[ResponseFormat] = None
+    """The response format for the model."""
+
+    temperature: Optional[float] = None
+    """The temperature of the model."""

letta_client/types/groq_model_settings_param.py

@@ -0,0 +1,33 @@
+# 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, TypeAlias, TypedDict
+
+from .text_response_format_param import TextResponseFormatParam
+from .json_object_response_format_param import JsonObjectResponseFormatParam
+from .json_schema_response_format_param import JsonSchemaResponseFormatParam
+
+__all__ = ["GroqModelSettingsParam", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class GroqModelSettingsParam(TypedDict, total=False):
+    """Groq 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["groq"]
+    """The type of the provider."""
+
+    response_format: Optional[ResponseFormat]
+    """The response format for the model."""
+
+    temperature: float
+    """The temperature of the model."""

letta_client/types/health_response.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["HealthResponse"]
+
+
+class HealthResponse(BaseModel):
+    """Health check response body"""
+
+    status: str
+
+    version: str