letta-client 1.0.0a5__py3-none-any.whl → 1.0.0a6__py3-none-any.whl

letta_sdk/types/source.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, Optional
+from datetime import datetime
+
+from .._models import BaseModel
+from .embedding_config import EmbeddingConfig
+from .vector_db_provider import VectorDBProvider
+
+__all__ = ["Source"]
+
+
+class Source(BaseModel):
+    embedding_config: EmbeddingConfig
+    """The embedding configuration used by the source."""
+
+    name: str
+    """The name of the source."""
+
+    id: Optional[str] = None
+    """The human-friendly ID of the Source"""
+
+    created_at: Optional[datetime] = None
+    """The timestamp when the source was created."""
+
+    created_by_id: Optional[str] = None
+    """The id of the user that made this Tool."""
+
+    description: Optional[str] = None
+    """The description of the source."""
+
+    instructions: Optional[str] = None
+    """Instructions for how to use the source."""
+
+    last_updated_by_id: Optional[str] = None
+    """The id of the user that made this Tool."""
+
+    metadata: Optional[Dict[str, object]] = None
+    """Metadata associated with the source."""
+
+    updated_at: Optional[datetime] = None
+    """The timestamp when the source was last updated."""
+
+    vector_db_provider: Optional[VectorDBProvider] = None
+    """The vector database provider used for this source's passages"""

letta_sdk/types/source_count_response.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import TypeAlias
+
+__all__ = ["SourceCountResponse"]
+
+SourceCountResponse: TypeAlias = int

letta_sdk/types/source_create_params.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 Dict, Optional
+from typing_extensions import Required, TypedDict
+
+from .embedding_config_param import EmbeddingConfigParam
+
+__all__ = ["SourceCreateParams"]
+
+
+class SourceCreateParams(TypedDict, total=False):
+    name: Required[str]
+    """The name of the source."""
+
+    description: Optional[str]
+    """The description of the source."""
+
+    embedding: Optional[str]
+    """The handle for the embedding config used by the source."""
+
+    embedding_chunk_size: Optional[int]
+    """The chunk size of the embedding."""
+
+    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."""

letta_sdk/types/source_get_agents_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__ = ["SourceGetAgentsResponse"]
+
+SourceGetAgentsResponse: TypeAlias = List[str]

letta_sdk/types/source_get_by_name_response.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import TypeAlias
+
+__all__ = ["SourceGetByNameResponse"]
+
+SourceGetByNameResponse: TypeAlias = str

letta_sdk/types/source_get_metadata_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__ = ["SourceGetMetadataParams"]
+
+
+class SourceGetMetadataParams(TypedDict, total=False):
+    include_detailed_per_source_metadata: bool

letta_sdk/types/source_list_passages_params.py

@@ -0,0 +1,19 @@
+# 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__ = ["SourceListPassagesParams"]
+
+
+class SourceListPassagesParams(TypedDict, total=False):
+    after: Optional[str]
+    """Message after which to retrieve the returned messages."""
+
+    before: Optional[str]
+    """Message before which to retrieve the returned messages."""
+
+    limit: int
+    """Maximum number of messages to retrieve."""

letta_sdk/types/source_list_passages_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .passage import Passage
+
+__all__ = ["SourceListPassagesResponse"]
+
+SourceListPassagesResponse: TypeAlias = List[Passage]

letta_sdk/types/source_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .source import Source
+
+__all__ = ["SourceListResponse"]
+
+SourceListResponse: TypeAlias = List[Source]

letta_sdk/types/source_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__ = ["SourceUpdateParams"]
+
+
+class SourceUpdateParams(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_sdk/types/source_upload_file_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 Optional
+from typing_extensions import Required, TypedDict
+
+from .._types import FileTypes
+from .duplicate_file_handling import DuplicateFileHandling
+
+__all__ = ["SourceUploadFileParams"]
+
+
+class SourceUploadFileParams(TypedDict, total=False):
+    file: Required[FileTypes]
+
+    duplicate_handling: DuplicateFileHandling
+    """How to handle duplicate filenames"""
+
+    name: Optional[str]
+    """Optional custom name to override the uploaded file's name"""

letta_sdk/types/sources/__init__.py

@@ -0,0 +1,7 @@
+# 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 .file_list_response import FileListResponse as FileListResponse
+from .file_retrieve_params import FileRetrieveParams as FileRetrieveParams

letta_sdk/types/sources/file_list_params.py

@@ -0,0 +1,26 @@
+# 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__ = ["FileListParams"]
+
+
+class FileListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Pagination cursor to fetch the next set of results"""
+
+    check_status_updates: bool
+    """Whether to check and update file processing status (from the vector db service).
+
+    If False, will not fetch and update the status, which may lead to performance
+    gains.
+    """
+
+    include_content: bool
+    """Whether to include full file content"""
+
+    limit: int
+    """Number of files to return"""

letta_sdk/types/sources/file_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from ..file_metadata import FileMetadata
+
+__all__ = ["FileListResponse"]
+
+FileListResponse: TypeAlias = List[FileMetadata]

letta_sdk/types/sources/file_retrieve_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_extensions import Required, TypedDict
+
+__all__ = ["FileRetrieveParams"]
+
+
+class FileRetrieveParams(TypedDict, total=False):
+    source_id: Required[str]
+
+    include_content: bool
+    """Whether to include full file content"""

letta_sdk/types/step.py

@@ -0,0 +1,92 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .agents.message import Message
+from .stop_reason_type import StopReasonType
+
+__all__ = ["Step"]
+
+
+class Step(BaseModel):
+    id: str
+    """The id of the step. Assigned by the database."""
+
+    agent_id: Optional[str] = None
+    """The ID of the agent that performed the step."""
+
+    completion_tokens: Optional[int] = None
+    """The number of tokens generated by the agent during this step."""
+
+    completion_tokens_details: Optional[Dict[str, object]] = None
+    """Metadata for the agent."""
+
+    context_window_limit: Optional[int] = None
+    """The context window limit configured for this step."""
+
+    error_data: Optional[Dict[str, object]] = None
+    """Error details including message, traceback, and additional context"""
+
+    error_type: Optional[str] = None
+    """The type/class of the error that occurred"""
+
+    feedback: Optional[Literal["positive", "negative"]] = None
+    """The feedback for this step. Must be either 'positive' or 'negative'."""
+
+    job_id: Optional[str] = None
+    """The unique identifier of the job that this step belongs to.
+
+    Only included for async calls.
+    """
+
+    messages: Optional[List[Message]] = None
+    """The messages generated during this step.
+
+    Deprecated: use `GET /v1/steps/{step_id}/messages` endpoint instead
+    """
+
+    model: Optional[str] = None
+    """The name of the model used for this step."""
+
+    api_model_endpoint: Optional[str] = FieldInfo(alias="model_endpoint", default=None)
+    """The model endpoint url used for this step."""
+
+    origin: Optional[str] = None
+    """The surface that this agent step was initiated from."""
+
+    project_id: Optional[str] = None
+    """The project that the agent that executed this step belongs to (cloud only)."""
+
+    prompt_tokens: Optional[int] = None
+    """The number of tokens in the prompt during this step."""
+
+    provider_category: Optional[str] = None
+    """The category of the provider used for this step."""
+
+    provider_id: Optional[str] = None
+    """The unique identifier of the provider that was configured for this step"""
+
+    provider_name: Optional[str] = None
+    """The name of the provider used for this step."""
+
+    status: Optional[Literal["pending", "success", "failed", "cancelled"]] = None
+    """Status of a step execution"""
+
+    stop_reason: Optional[StopReasonType] = None
+    """The stop reason associated with the step."""
+
+    tags: Optional[List[str]] = None
+    """Metadata tags."""
+
+    tid: Optional[str] = None
+    """The unique identifier of the transaction that processed this step."""
+
+    total_tokens: Optional[int] = None
+    """The total number of tokens processed by the agent during this step."""
+
+    trace_id: Optional[str] = None
+    """The trace id of the agent step."""

letta_sdk/types/step_list_messages_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__ = ["StepListMessagesParams"]
+
+
+class StepListMessagesParams(TypedDict, total=False):
+    after: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come after this message ID in the specified sort order
+    """
+
+    before: Optional[str]
+    """Message ID cursor for pagination.
+
+    Returns messages that come before this message ID in the specified sort order
+    """
+
+    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"]
+    """Sort by field"""

letta_sdk/types/step_list_messages_response.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union
+from typing_extensions import Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .agents.user_message import UserMessage
+from .tool_return_message import ToolReturnMessage
+from .agents.system_message import SystemMessage
+from .agents.assistant_message import AssistantMessage
+from .agents.reasoning_message import ReasoningMessage
+from .agents.tool_call_message import ToolCallMessage
+from .agents.approval_request_message import ApprovalRequestMessage
+from .agents.hidden_reasoning_message import HiddenReasoningMessage
+from .agents.approval_response_message import ApprovalResponseMessage
+
+__all__ = ["StepListMessagesResponse", "StepListMessagesResponseItem"]
+
+StepListMessagesResponseItem: TypeAlias = Annotated[
+    Union[
+        SystemMessage,
+        UserMessage,
+        ReasoningMessage,
+        HiddenReasoningMessage,
+        ToolCallMessage,
+        ToolReturnMessage,
+        AssistantMessage,
+        ApprovalRequestMessage,
+        ApprovalResponseMessage,
+    ],
+    PropertyInfo(discriminator="message_type"),
+]
+
+StepListMessagesResponse: TypeAlias = List[StepListMessagesResponseItem]

letta_sdk/types/step_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 Optional
+from typing_extensions import Literal, Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = ["StepListParams"]
+
+
+class StepListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Return steps after this step ID"""
+
+    agent_id: Optional[str]
+    """Filter by the ID of the agent that performed the step"""
+
+    before: Optional[str]
+    """Return steps before this step ID"""
+
+    end_date: Optional[str]
+    """Return steps before this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")"""
+
+    feedback: Optional[Literal["positive", "negative"]]
+    """Filter by feedback"""
+
+    has_feedback: Optional[bool]
+    """Filter by whether steps have feedback (true) or not (false)"""
+
+    limit: Optional[int]
+    """Maximum number of steps to return"""
+
+    model: Optional[str]
+    """Filter by the name of the model used for the step"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for steps by creation time.
+
+    'asc' for oldest first, 'desc' for newest first
+    """
+
+    order_by: Literal["created_at"]
+    """Field to sort by"""
+
+    project_id: Optional[str]
+    """Filter by the project ID that is associated with the step (cloud only)."""
+
+    start_date: Optional[str]
+    """Return steps after this ISO datetime (e.g. "2025-01-29T15:01:19-08:00")"""
+
+    tags: Optional[SequenceNotStr[str]]
+    """Filter by tags"""
+
+    trace_ids: Optional[SequenceNotStr[str]]
+    """Filter by trace ids returned by the server"""
+
+    x_project: Annotated[str, PropertyInfo(alias="X-Project")]
+    """Filter by project slug to associate with the group (cloud only)."""

letta_sdk/types/step_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .step import Step
+
+__all__ = ["StepListResponse"]
+
+StepListResponse: TypeAlias = List[Step]

letta_sdk/types/step_retrieve_metrics_response.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+
+__all__ = ["StepRetrieveMetricsResponse"]
+
+
+class StepRetrieveMetricsResponse(BaseModel):
+    id: str
+    """The id of the step this metric belongs to (matches steps.id)."""
+
+    agent_id: Optional[str] = None
+    """The unique identifier of the agent."""
+
+    base_template_id: Optional[str] = None
+    """The base template ID that the step belongs to (cloud only)."""
+
+    job_id: Optional[str] = None
+    """The unique identifier of the job."""
+
+    llm_request_ns: Optional[int] = None
+    """Time spent on LLM requests in nanoseconds."""
+
+    llm_request_start_ns: Optional[int] = None
+    """The timestamp of the start of the llm request in nanoseconds."""
+
+    project_id: Optional[str] = None
+    """The project that the step belongs to (cloud only)."""
+
+    provider_id: Optional[str] = None
+    """The unique identifier of the provider."""
+
+    step_ns: Optional[int] = None
+    """Total time for the step in nanoseconds."""
+
+    step_start_ns: Optional[int] = None
+    """The timestamp of the start of the step in nanoseconds."""
+
+    template_id: Optional[str] = None
+    """The template ID that the step belongs to (cloud only)."""
+
+    tool_execution_ns: Optional[int] = None
+    """Time spent on tool execution in nanoseconds."""

letta_sdk/types/step_update_feedback_params.py

@@ -0,0 +1,18 @@
+# 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
+
+from .._types import SequenceNotStr
+
+__all__ = ["StepUpdateFeedbackParams"]
+
+
+class StepUpdateFeedbackParams(TypedDict, total=False):
+    feedback: Optional[Literal["positive", "negative"]]
+    """Whether this feedback is positive or negative"""
+
+    tags: Optional[SequenceNotStr[str]]
+    """Feedback tags to add to the step"""

letta_sdk/types/stop_reason_type.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["StopReasonType"]
+
+StopReasonType: TypeAlias = Literal[
+    "end_turn",
+    "error",
+    "llm_api_error",
+    "invalid_llm_response",
+    "invalid_tool_call",
+    "max_steps",
+    "no_tool_call",
+    "tool_rule",
+    "cancelled",
+    "requires_approval",
+]

letta_sdk/types/supervisor_manager_param.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["SupervisorManagerParam"]
+
+
+class SupervisorManagerParam(TypedDict, total=False):
+    manager_agent_id: Required[str]
+
+    manager_type: Literal["supervisor"]

letta_sdk/types/tag_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__ = ["TagListParams"]
+
+
+class TagListParams(TypedDict, total=False):
+    after: Optional[str]
+    """Tag cursor for pagination.
+
+    Returns tags that come after this tag in the specified sort order
+    """
+
+    before: Optional[str]
+    """Tag cursor for pagination.
+
+    Returns tags that come before this tag in the specified sort order
+    """
+
+    limit: Optional[int]
+    """Maximum number of tags to return"""
+
+    name: Optional[str]
+    """Filter tags by name"""
+
+    order: Literal["asc", "desc"]
+    """Sort order for tags.
+
+    'asc' for alphabetical order, 'desc' for reverse alphabetical order
+    """
+
+    order_by: Literal["name"]
+    """Field to sort by"""
+
+    query_text: Optional[str]
+    """Filter tags by text search. Deprecated, please use name field instead"""

letta_sdk/types/tag_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__ = ["TagListResponse"]
+
+TagListResponse: TypeAlias = List[str]