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

letta_client/types/archive_create_params.py

@@ -0,0 +1,22 @@
+# 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 Required, TypedDict
+
+from .embedding_config_param import EmbeddingConfigParam
+
+__all__ = ["ArchiveCreateParams"]
+
+
+class ArchiveCreateParams(TypedDict, total=False):
+    name: Required[str]
+
+    description: Optional[str]
+
+    embedding: Optional[str]
+    """Embedding model handle for the archive"""
+
+    embedding_config: Optional[EmbeddingConfigParam]
+    """Configuration for embedding model connection and processing parameters."""

letta_client/types/archive_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__ = ["ArchiveListParams"]
+
+
+class ArchiveListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Archive ID cursor for pagination.
+
+    Returns archives that come after this archive ID in the specified sort order
+    """
+
+    agent_id: Optional[str]
+    """Only archives attached to this agent ID"""
+
+    before: Optional[str]
+    """Archive ID cursor for pagination.
+
+    Returns archives that come before this archive ID in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of archives to return"""
+
+    name: Optional[str]
+    """Filter by archive name (exact match)"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for archives by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""

letta_client/types/archive_update_params.py

@@ -0,0 +1,14 @@
+# 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 TypedDict
+
+__all__ = ["ArchiveUpdateParams"]
+
+
+class ArchiveUpdateParams(TypedDict, total=False):
+    description: Optional[str]
+
+    name: Optional[str]

letta_client/types/archives/__init__.py

@@ -0,0 +1,5 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .passage_create_params import PassageCreateParams as PassageCreateParams

letta_client/types/archives/passage_create_params.py

@@ -0,0 +1,21 @@
+# 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
+
+from ..._types import SequenceNotStr
+
+__all__ = ["PassageCreateParams"]
+
+
+class PassageCreateParams(TypedDict, total=False):
+    text: Required[str]
+    """The text content of the passage"""
+
+    metadata: Optional[Dict[str, object]]
+    """Optional metadata for the passage"""
+
+    tags: Optional[SequenceNotStr[str]]
+    """Optional tags for categorizing the passage"""

letta_client/types/azure_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__ = ["AzureModelSettings", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class AzureModelSettings(BaseModel):
+    """Azure OpenAI 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["azure"]] = 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/azure_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__ = ["AzureModelSettingsParam", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class AzureModelSettingsParam(TypedDict, total=False):
+    """Azure OpenAI 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["azure"]
+    """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/bedrock_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__ = ["BedrockModelSettings", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Annotated[
+    Union[TextResponseFormat, JsonSchemaResponseFormat, JsonObjectResponseFormat, None],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class BedrockModelSettings(BaseModel):
+    """AWS Bedrock model configuration."""
+
+    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["bedrock"]] = 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/bedrock_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__ = ["BedrockModelSettingsParam", "ResponseFormat"]
+
+ResponseFormat: TypeAlias = Union[TextResponseFormatParam, JsonSchemaResponseFormatParam, JsonObjectResponseFormatParam]
+
+
+class BedrockModelSettingsParam(TypedDict, total=False):
+    """AWS Bedrock model configuration."""
+
+    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["bedrock"]
+    """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/block_create_params.py

@@ -0,0 +1,59 @@
+# 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
+
+from .._types import SequenceNotStr
+
+__all__ = ["BlockCreateParams"]
+
+
+class BlockCreateParams(TypedDict, total=False):
+    label: Required[str]
+    """Label of the block."""
+
+    value: Required[str]
+    """Value of the block."""
+
+    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
+
+    limit: int
+    """Character limit of the block."""
+
+    metadata: Optional[Dict[str, object]]
+    """Metadata of the block."""
+
+    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."""
+
+    tags: Optional[SequenceNotStr[str]]
+    """The tags to associate with the block."""
+
+    template_id: Optional[str]
+    """The id of the template."""
+
+    template_name: Optional[str]
+    """Name of the block if it is a template."""

letta_client/types/block_list_params.py

@@ -0,0 +1,102 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable, Optional
+from typing_extensions import Literal, TypedDict
+
+from .._types import SequenceNotStr
+
+__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
+    """
+
+    connected_to_agents_count_eq: Optional[Iterable[int]]
+    """Filter blocks by the exact number of connected agents.
+
+    If provided, returns blocks that have exactly this number of connected agents.
+    """
+
+    connected_to_agents_count_gt: Optional[int]
+    """Filter blocks by the number of connected agents.
+
+    If provided, returns blocks that have more than this number of connected agents.
+    """
+
+    connected_to_agents_count_lt: Optional[int]
+    """Filter blocks by the number of connected agents.
+
+    If provided, returns blocks that have less than this number of connected agents.
+    """
+
+    description_search: Optional[str]
+    """Search blocks by description.
+
+    If provided, returns blocks whose description matches the search query. This is
+    a full-text search on block descriptions.
+    """
+
+    identifier_keys: Optional[SequenceNotStr[str]]
+    """Search agents by identifier keys"""
+
+    identity_id: Optional[str]
+    """The ID of the identity in the format 'identity-<uuid4>'"""
+
+    label: Optional[str]
+    """Label to include (alphanumeric, hyphens, underscores, forward slashes)"""
+
+    label_search: Optional[str]
+    """Search blocks by label.
+
+    If provided, returns blocks whose label matches the search query. This is a
+    full-text search on block labels.
+    """
+
+    limit: Optional[int]
+    """Number of blocks to return"""
+
+    match_all_tags: bool
+    """If True, only returns blocks that match ALL given tags.
+
+    Otherwise, return blocks that have ANY of the passed-in tags.
+    """
+
+    name: Optional[str]
+    """Name filter (alphanumeric, spaces, hyphens, underscores)"""
+
+    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"""
+
+    project_id: Optional[str]
+    """Search blocks by project id"""
+
+    tags: Optional[SequenceNotStr[str]]
+    """List of tags to filter blocks by"""
+
+    templates_only: bool
+    """Whether to include only templates"""
+
+    value_search: Optional[str]
+    """Search blocks by value.
+
+    If provided, returns blocks whose value matches the search query. This is a
+    full-text search on block values.
+    """

letta_client/types/block_response.py

@@ -0,0 +1,66 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+
+from .._models import BaseModel
+
+__all__ = ["BlockResponse"]
+
+
+class BlockResponse(BaseModel):
+    id: str
+    """The id of the block."""
+
+    value: str
+    """Value of the block."""
+
+    base_template_id: Optional[str] = None
+    """(Deprecated) 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
+    """(Deprecated) The id of the deployment."""
+
+    description: Optional[str] = None
+    """Description of the block."""
+
+    entity_id: Optional[str] = None
+    """(Deprecated) The id of the entity within the template."""
+
+    hidden: Optional[bool] = None
+    """(Deprecated) 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."""
+
+    preserve_on_migration: Optional[bool] = None
+    """(Deprecated) Preserve the block on template migration."""
+
+    project_id: Optional[str] = None
+    """The associated project id."""
+
+    read_only: Optional[bool] = None
+    """(Deprecated) Whether the agent has read-only access to the block."""
+
+    tags: Optional[List[str]] = None
+    """The tags associated with the block."""
+
+    template_id: Optional[str] = None
+    """(Deprecated) The id of the template."""
+
+    template_name: Optional[str] = None
+    """(Deprecated) The name of the block template (if it is a template)."""

letta_client/types/block_update_params.py

@@ -0,0 +1,60 @@
+# 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 .._types import SequenceNotStr
+
+__all__ = ["BlockUpdateParams"]
+
+
+class BlockUpdateParams(TypedDict, total=False):
+    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."""
+
+    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."""
+
+    tags: Optional[SequenceNotStr[str]]
+    """The tags to associate with the block."""
+
+    template_id: Optional[str]
+    """The id of the template."""
+
+    template_name: Optional[str]
+    """Name of the block if it is a template."""
+
+    value: Optional[str]
+    """Value of the block."""

letta_client/types/blocks/__init__.py

@@ -0,0 +1,5 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .agent_list_params import AgentListParams as AgentListParams

letta_client/types/blocks/agent_list_params.py

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Literal, TypedDict
+
+from ..._types import SequenceNotStr
+
+__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
+    """
+
+    include: List[
+        Literal[
+            "agent.blocks",
+            "agent.identities",
+            "agent.managed_group",
+            "agent.pending_approval",
+            "agent.secrets",
+            "agent.sources",
+            "agent.tags",
+            "agent.tools",
+        ]
+    ]
+    """Specify which relational fields to include in the response.
+
+    No relationships are included by default.
+    """
+
+    include_relationships: Optional[SequenceNotStr[str]]
+    """
+    Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+    in the response. If not provided, all relationships are loaded by default. Using
+    this can optimize performance by reducing unnecessary joins.This is a legacy
+    parameter, and no longer supported after 1.0.0 SDK versions.
+    """
+
+    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"""