letta-client 0.1.305__py3-none-any.whl → 0.1.307__py3-none-any.whl

letta_client/__init__.py

@@ -19,6 +19,8 @@ from .types import (
     ApprovalCreate,
     ApprovalRequestMessage,
     ApprovalResponseMessage,
+    ArchivalMemorySearchResponse,
+    ArchivalMemorySearchResult,
     AssistantMessage,
     AssistantMessageContent,
     Audio,
@@ -384,6 +386,7 @@ from .templates import (
     TemplatesForkTemplateResponse,
     TemplatesGetTemplateSnapshotResponse,
     TemplatesGetTemplateSnapshotResponseAgentsItem,
+    TemplatesGetTemplateSnapshotResponseAgentsItemAgentType,
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables,
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem,
     TemplatesGetTemplateSnapshotResponseAgentsItemProperties,
@@ -452,6 +455,8 @@ __all__ = [
     "ApprovalCreate",
     "ApprovalRequestMessage",
     "ApprovalResponseMessage",
+    "ArchivalMemorySearchResponse",
+    "ArchivalMemorySearchResult",
     "AssistantMessage",
     "AssistantMessageContent",
     "AsyncLetta",
@@ -742,6 +747,7 @@ __all__ = [
     "TemplatesForkTemplateResponse",
     "TemplatesGetTemplateSnapshotResponse",
     "TemplatesGetTemplateSnapshotResponseAgentsItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemAgentType",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem",
     "TemplatesGetTemplateSnapshotResponseAgentsItemProperties",

letta_client/agents/__init__.py

@@ -39,6 +39,7 @@ from .messages import (
     MessagesModifyResponse,
     MessagesPreviewRawPayloadRequest,
 )
+from .passages import PassagesSearchRequestTagMatchMode
 from .templates import TemplatesMigrateResponse
 
 __all__ = [
@@ -59,6 +60,7 @@ __all__ = [
     "MessagesModifyRequest",
     "MessagesModifyResponse",
     "MessagesPreviewRawPayloadRequest",
+    "PassagesSearchRequestTagMatchMode",
     "TemplatesMigrateResponse",
     "UpdateAgentResponseFormat",
     "UpdateAgentToolRulesItem",

letta_client/agents/passages/__init__.py

@@ -2,3 +2,6 @@
 
 # isort: skip_file
 
+from .types import PassagesSearchRequestTagMatchMode
+
+__all__ = ["PassagesSearchRequestTagMatchMode"]

letta_client/agents/passages/client.py

@@ -5,8 +5,10 @@ import typing
 
 from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
 from ...core.request_options import RequestOptions
+from ...types.archival_memory_search_response import ArchivalMemorySearchResponse
 from ...types.passage import Passage
 from .raw_client import AsyncRawPassagesClient, RawPassagesClient
+from .types.passages_search_request_tag_match_mode import PassagesSearchRequestTagMatchMode
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -142,6 +144,80 @@ class PassagesClient:
         )
         return _response.data
 
+    def search(
+        self,
+        agent_id: str,
+        *,
+        query: str,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_match_mode: typing.Optional[PassagesSearchRequestTagMatchMode] = None,
+        top_k: typing.Optional[int] = None,
+        start_datetime: typing.Optional[str] = None,
+        end_datetime: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ArchivalMemorySearchResponse:
+        """
+        Search archival memory using semantic (embedding-based) search with optional temporal filtering.
+
+        This endpoint allows manual triggering of archival memory searches, enabling users to query
+        an agent's archival memory store directly via the API. The search uses the same functionality
+        as the agent's archival_memory_search tool but is accessible for external API usage.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        query : str
+            String to search for using semantic similarity
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Optional list of tags to filter search results
+
+        tag_match_mode : typing.Optional[PassagesSearchRequestTagMatchMode]
+            How to match tags - 'any' to match passages with any of the tags, 'all' to match only passages with all tags
+
+        top_k : typing.Optional[int]
+            Maximum number of results to return. Uses system default if not specified
+
+        start_datetime : typing.Optional[str]
+            Filter results to passages created after this datetime. ISO 8601 format
+
+        end_datetime : typing.Optional[str]
+            Filter results to passages created before this datetime. ISO 8601 format
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ArchivalMemorySearchResponse
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.agents.passages.search(
+            agent_id="agent_id",
+            query="query",
+        )
+        """
+        _response = self._raw_client.search(
+            agent_id,
+            query=query,
+            tags=tags,
+            tag_match_mode=tag_match_mode,
+            top_k=top_k,
+            start_datetime=start_datetime,
+            end_datetime=end_datetime,
+            request_options=request_options,
+        )
+        return _response.data
+
     def delete(
         self, agent_id: str, memory_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.Optional[typing.Any]:
@@ -356,6 +432,88 @@ class AsyncPassagesClient:
         )
         return _response.data
 
+    async def search(
+        self,
+        agent_id: str,
+        *,
+        query: str,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_match_mode: typing.Optional[PassagesSearchRequestTagMatchMode] = None,
+        top_k: typing.Optional[int] = None,
+        start_datetime: typing.Optional[str] = None,
+        end_datetime: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ArchivalMemorySearchResponse:
+        """
+        Search archival memory using semantic (embedding-based) search with optional temporal filtering.
+
+        This endpoint allows manual triggering of archival memory searches, enabling users to query
+        an agent's archival memory store directly via the API. The search uses the same functionality
+        as the agent's archival_memory_search tool but is accessible for external API usage.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        query : str
+            String to search for using semantic similarity
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Optional list of tags to filter search results
+
+        tag_match_mode : typing.Optional[PassagesSearchRequestTagMatchMode]
+            How to match tags - 'any' to match passages with any of the tags, 'all' to match only passages with all tags
+
+        top_k : typing.Optional[int]
+            Maximum number of results to return. Uses system default if not specified
+
+        start_datetime : typing.Optional[str]
+            Filter results to passages created after this datetime. ISO 8601 format
+
+        end_datetime : typing.Optional[str]
+            Filter results to passages created before this datetime. ISO 8601 format
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ArchivalMemorySearchResponse
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agents.passages.search(
+                agent_id="agent_id",
+                query="query",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.search(
+            agent_id,
+            query=query,
+            tags=tags,
+            tag_match_mode=tag_match_mode,
+            top_k=top_k,
+            start_datetime=start_datetime,
+            end_datetime=end_datetime,
+            request_options=request_options,
+        )
+        return _response.data
+
     async def delete(
         self, agent_id: str, memory_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> typing.Optional[typing.Any]:

letta_client/agents/passages/raw_client.py

@@ -11,8 +11,10 @@ from ...core.jsonable_encoder import jsonable_encoder
 from ...core.request_options import RequestOptions
 from ...core.unchecked_base_model import construct_type
 from ...errors.unprocessable_entity_error import UnprocessableEntityError
+from ...types.archival_memory_search_response import ArchivalMemorySearchResponse
 from ...types.http_validation_error import HttpValidationError
 from ...types.passage import Passage
+from .types.passages_search_request_tag_match_mode import PassagesSearchRequestTagMatchMode
 
 # this is used as the default value for optional parameters
 OMIT = typing.cast(typing.Any, ...)
@@ -174,6 +176,94 @@ class RawPassagesClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    def search(
+        self,
+        agent_id: str,
+        *,
+        query: str,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_match_mode: typing.Optional[PassagesSearchRequestTagMatchMode] = None,
+        top_k: typing.Optional[int] = None,
+        start_datetime: typing.Optional[str] = None,
+        end_datetime: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> HttpResponse[ArchivalMemorySearchResponse]:
+        """
+        Search archival memory using semantic (embedding-based) search with optional temporal filtering.
+
+        This endpoint allows manual triggering of archival memory searches, enabling users to query
+        an agent's archival memory store directly via the API. The search uses the same functionality
+        as the agent's archival_memory_search tool but is accessible for external API usage.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        query : str
+            String to search for using semantic similarity
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Optional list of tags to filter search results
+
+        tag_match_mode : typing.Optional[PassagesSearchRequestTagMatchMode]
+            How to match tags - 'any' to match passages with any of the tags, 'all' to match only passages with all tags
+
+        top_k : typing.Optional[int]
+            Maximum number of results to return. Uses system default if not specified
+
+        start_datetime : typing.Optional[str]
+            Filter results to passages created after this datetime. ISO 8601 format
+
+        end_datetime : typing.Optional[str]
+            Filter results to passages created before this datetime. ISO 8601 format
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[ArchivalMemorySearchResponse]
+            Successful Response
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival-memory/search",
+            method="GET",
+            params={
+                "query": query,
+                "tags": tags,
+                "tag_match_mode": tag_match_mode,
+                "top_k": top_k,
+                "start_datetime": start_datetime,
+                "end_datetime": end_datetime,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ArchivalMemorySearchResponse,
+                    construct_type(
+                        type_=ArchivalMemorySearchResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     def delete(
         self, agent_id: str, memory_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> HttpResponse[typing.Optional[typing.Any]]:
@@ -414,6 +504,94 @@ class AsyncRawPassagesClient:
             raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
         raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
 
+    async def search(
+        self,
+        agent_id: str,
+        *,
+        query: str,
+        tags: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        tag_match_mode: typing.Optional[PassagesSearchRequestTagMatchMode] = None,
+        top_k: typing.Optional[int] = None,
+        start_datetime: typing.Optional[str] = None,
+        end_datetime: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncHttpResponse[ArchivalMemorySearchResponse]:
+        """
+        Search archival memory using semantic (embedding-based) search with optional temporal filtering.
+
+        This endpoint allows manual triggering of archival memory searches, enabling users to query
+        an agent's archival memory store directly via the API. The search uses the same functionality
+        as the agent's archival_memory_search tool but is accessible for external API usage.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        query : str
+            String to search for using semantic similarity
+
+        tags : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Optional list of tags to filter search results
+
+        tag_match_mode : typing.Optional[PassagesSearchRequestTagMatchMode]
+            How to match tags - 'any' to match passages with any of the tags, 'all' to match only passages with all tags
+
+        top_k : typing.Optional[int]
+            Maximum number of results to return. Uses system default if not specified
+
+        start_datetime : typing.Optional[str]
+            Filter results to passages created after this datetime. ISO 8601 format
+
+        end_datetime : typing.Optional[str]
+            Filter results to passages created before this datetime. ISO 8601 format
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[ArchivalMemorySearchResponse]
+            Successful Response
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/archival-memory/search",
+            method="GET",
+            params={
+                "query": query,
+                "tags": tags,
+                "tag_match_mode": tag_match_mode,
+                "top_k": top_k,
+                "start_datetime": start_datetime,
+                "end_datetime": end_datetime,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    ArchivalMemorySearchResponse,
+                    construct_type(
+                        type_=ArchivalMemorySearchResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    headers=dict(_response.headers),
+                    body=typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
     async def delete(
         self, agent_id: str, memory_id: str, *, request_options: typing.Optional[RequestOptions] = None
     ) -> AsyncHttpResponse[typing.Optional[typing.Any]]:

letta_client/agents/passages/types/__init__.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+from .passages_search_request_tag_match_mode import PassagesSearchRequestTagMatchMode
+
+__all__ = ["PassagesSearchRequestTagMatchMode"]

letta_client/agents/passages/types/passages_search_request_tag_match_mode.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+PassagesSearchRequestTagMatchMode = typing.Union[typing.Literal["any", "all"], typing.Any]

letta_client/core/client_wrapper.py

@@ -24,10 +24,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "letta-client/0.1.305",
+            "User-Agent": "letta-client/0.1.307",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.305",
+            "X-Fern-SDK-Version": "0.1.307",
             **(self.get_custom_headers() or {}),
         }
         if self._project is not None:

letta_client/templates/__init__.py

@@ -8,6 +8,7 @@ from .types import (
     TemplatesForkTemplateResponse,
     TemplatesGetTemplateSnapshotResponse,
     TemplatesGetTemplateSnapshotResponseAgentsItem,
+    TemplatesGetTemplateSnapshotResponseAgentsItemAgentType,
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables,
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem,
     TemplatesGetTemplateSnapshotResponseAgentsItemProperties,
@@ -50,6 +51,7 @@ __all__ = [
     "TemplatesForkTemplateResponse",
     "TemplatesGetTemplateSnapshotResponse",
     "TemplatesGetTemplateSnapshotResponseAgentsItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemAgentType",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem",
     "TemplatesGetTemplateSnapshotResponseAgentsItemProperties",

letta_client/templates/types/__init__.py

@@ -7,6 +7,9 @@ from .templates_delete_template_response import TemplatesDeleteTemplateResponse
 from .templates_fork_template_response import TemplatesForkTemplateResponse
 from .templates_get_template_snapshot_response import TemplatesGetTemplateSnapshotResponse
 from .templates_get_template_snapshot_response_agents_item import TemplatesGetTemplateSnapshotResponseAgentsItem
+from .templates_get_template_snapshot_response_agents_item_agent_type import (
+    TemplatesGetTemplateSnapshotResponseAgentsItemAgentType,
+)
 from .templates_get_template_snapshot_response_agents_item_memory_variables import (
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables,
 )
@@ -69,6 +72,7 @@ __all__ = [
     "TemplatesForkTemplateResponse",
     "TemplatesGetTemplateSnapshotResponse",
     "TemplatesGetTemplateSnapshotResponseAgentsItem",
+    "TemplatesGetTemplateSnapshotResponseAgentsItemAgentType",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables",
     "TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariablesDataItem",
     "TemplatesGetTemplateSnapshotResponseAgentsItemProperties",

letta_client/templates/types/templates_get_template_snapshot_response_agents_item.py

@@ -7,6 +7,9 @@ import typing_extensions
 from ...core.pydantic_utilities import IS_PYDANTIC_V2
 from ...core.serialization import FieldMetadata
 from ...core.unchecked_base_model import UncheckedBaseModel
+from .templates_get_template_snapshot_response_agents_item_agent_type import (
+    TemplatesGetTemplateSnapshotResponseAgentsItemAgentType,
+)
 from .templates_get_template_snapshot_response_agents_item_memory_variables import (
     TemplatesGetTemplateSnapshotResponseAgentsItemMemoryVariables,
 )
@@ -43,6 +46,9 @@ class TemplatesGetTemplateSnapshotResponseAgentsItem(UncheckedBaseModel):
         typing.Optional[typing.List[TemplatesGetTemplateSnapshotResponseAgentsItemToolRulesItem]],
         FieldMetadata(alias="toolRules"),
     ] = None
+    agent_type: typing_extensions.Annotated[
+        TemplatesGetTemplateSnapshotResponseAgentsItemAgentType, FieldMetadata(alias="agentType")
+    ]
     entity_id: typing_extensions.Annotated[str, FieldMetadata(alias="entityId")]
     name: str
 

letta_client/templates/types/templates_get_template_snapshot_response_agents_item_agent_type.py

@@ -0,0 +1,17 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+TemplatesGetTemplateSnapshotResponseAgentsItemAgentType = 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,
+]

letta_client/templates/types/templates_get_template_snapshot_response_configuration.py

@@ -10,7 +10,9 @@ from ...core.unchecked_base_model import UncheckedBaseModel
 
 
 class TemplatesGetTemplateSnapshotResponseConfiguration(UncheckedBaseModel):
-    manager_agent_id: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="managerAgentId")] = None
+    manager_agent_entity_id: typing_extensions.Annotated[
+        typing.Optional[str], FieldMetadata(alias="managerAgentEntityId")
+    ] = None
     manager_type: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="managerType")] = None
     termination_token: typing_extensions.Annotated[typing.Optional[str], FieldMetadata(alias="terminationToken")] = None
     max_turns: typing_extensions.Annotated[typing.Optional[float], FieldMetadata(alias="maxTurns")] = None

letta_client/types/__init__.py

@@ -18,6 +18,8 @@ from .app_model import AppModel
 from .approval_create import ApprovalCreate
 from .approval_request_message import ApprovalRequestMessage
 from .approval_response_message import ApprovalResponseMessage
+from .archival_memory_search_response import ArchivalMemorySearchResponse
+from .archival_memory_search_result import ArchivalMemorySearchResult
 from .assistant_message import AssistantMessage
 from .assistant_message_content import AssistantMessageContent
 from .audio import Audio
@@ -357,6 +359,8 @@ __all__ = [
     "ApprovalCreate",
     "ApprovalRequestMessage",
     "ApprovalResponseMessage",
+    "ArchivalMemorySearchResponse",
+    "ArchivalMemorySearchResult",
     "AssistantMessage",
     "AssistantMessageContent",
     "Audio",

letta_client/types/archival_memory_search_response.py

@@ -0,0 +1,29 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+from .archival_memory_search_result import ArchivalMemorySearchResult
+
+
+class ArchivalMemorySearchResponse(UncheckedBaseModel):
+    results: typing.List[ArchivalMemorySearchResult] = pydantic.Field()
+    """
+    List of search results matching the query
+    """
+
+    count: int = pydantic.Field()
+    """
+    Total number of results returned
+    """
+
+    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

letta_client/types/archival_memory_search_result.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+from ..core.unchecked_base_model import UncheckedBaseModel
+
+
+class ArchivalMemorySearchResult(UncheckedBaseModel):
+    timestamp: str = pydantic.Field()
+    """
+    Timestamp of when the memory was created, formatted in agent's timezone
+    """
+
+    content: str = pydantic.Field()
+    """
+    Text content of the archival memory passage
+    """
+
+    tags: typing.Optional[typing.List[str]] = pydantic.Field(default=None)
+    """
+    List of tags associated with this memory
+    """
+
+    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

{letta_client-0.1.305.dist-info → letta_client-0.1.307.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.305
+Version: 0.1.307
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{letta_client-0.1.305.dist-info → letta_client-0.1.307.dist-info}/RECORD

@@ -1,5 +1,5 @@
-letta_client/__init__.py,sha256=5zuBCbEolWRe3lWOHAaRJhOJlf5nhzaBBx-QcyOAGyQ,27077
-letta_client/agents/__init__.py,sha256=_Pbfo96Sq78LfmkAYzx3nnkcobGfEKOx95AL1JswReY,1984
+letta_client/__init__.py,sha256=yIQqDFRQsrM3faBRzTcdY9jIUVHAgcD3RpytQ7ee5ro,27337
+letta_client/agents/__init__.py,sha256=6U2CPqYOtgufFoEhev61AzE-oOqgAQPUBsN8H7YJDbg,2081
 letta_client/agents/blocks/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/agents/blocks/client.py,sha256=CUwVh5FHgD0YP3VNhUrWdkedMWk49yH3IiDD589AWEM,15809
 letta_client/agents/blocks/raw_client.py,sha256=Cx_85c78oqIOPZIPfCOsIa8WOL2EUNRwXJRGbOqn2AA,25570
@@ -33,9 +33,11 @@ letta_client/agents/messages/types/letta_streaming_response.py,sha256=TEqXH71L62
 letta_client/agents/messages/types/messages_modify_request.py,sha256=0NT3pgbqQItc_p5cjBl4MaJ6bIMAlMhvdBJWm9zilpQ,476
 letta_client/agents/messages/types/messages_modify_response.py,sha256=0nbkp7q7iaM2esLkdmIe0CYpJWY6LYtR3V-WkKaAy-g,871
 letta_client/agents/messages/types/messages_preview_raw_payload_request.py,sha256=ncI14H-30FLJujezUyk2yS7Jfqf7TqqhcWejWXQ4pcE,283
-letta_client/agents/passages/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
-letta_client/agents/passages/client.py,sha256=AJvkZDBFHBxPxP0acxcZ7ugfv-y32y7wyyJiK-uQch4,11839
-letta_client/agents/passages/raw_client.py,sha256=_LCdUryyZrLYRdZeCmHChcS3nqwUKG4X4369YF3Cops,18644
+letta_client/agents/passages/__init__.py,sha256=wA0bocGcbmgb62sL9MEWpKzP_KBVv8KHhvc6vZH6MOE,187
+letta_client/agents/passages/client.py,sha256=LB0pnikhFV__igj6LW7uWWBdfi4FSs7BIicuuauLNm4,17391
+letta_client/agents/passages/raw_client.py,sha256=MdRBgCsArv_ZDUGvOI-VS5KI9Lnilh3F7NUvQI_iV8c,26249
+letta_client/agents/passages/types/__init__.py,sha256=zA5psnkblMdGa_kOTKkqZmMPtryV1uGScnWFeI9fuu4,220
+letta_client/agents/passages/types/passages_search_request_tag_match_mode.py,sha256=cgAkixKi6VCJGFHUtjEzYdgq9KJcn5nrEMbR3zKp2rE,171
 letta_client/agents/raw_client.py,sha256=h3USsoctFijFNYUQDi6OdgvpJBtj7a8ekrL58EtsV7A,97954
 letta_client/agents/sources/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/agents/sources/client.py,sha256=lCqB6FF9svrwf0oZSFs41WKlMXc-YRhUeb4FZkHbicM,6868
@@ -90,7 +92,7 @@ letta_client/client_side_access_tokens/types/client_side_access_tokens_list_clie
 letta_client/client_side_access_tokens/types/client_side_access_tokens_list_client_side_access_tokens_response_tokens_item_policy_data_item_access_item.py,sha256=kNHfEWFl7u71Pu8NPqutod0a2NXfvq8il05Hqm0iBB4,284
 letta_client/core/__init__.py,sha256=tpn7rjb6C2UIkYZYIqdrNpI7Yax2jw88sXh2baxaxAI,1715
 letta_client/core/api_error.py,sha256=44vPoTyWN59gonCIZMdzw7M1uspygiLnr3GNFOoVL2Q,614
-letta_client/core/client_wrapper.py,sha256=ajDWOenlwXtUBW2WYWU3InuxNViUbZ76CKDRU26gvn4,2776
+letta_client/core/client_wrapper.py,sha256=8r7jrTWpdOcWp-vCZdO03D9wG4qoWLa_DSNK3NQCpwU,2776
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/force_multipart.py,sha256=awxh5MtcRYe74ehY8U76jzv6fYM_w_D3Rur7KQQzSDk,429
@@ -200,7 +202,7 @@ letta_client/tags/raw_client.py,sha256=DQXEgzOuCygBMbzX63Sc9UwfueALa5rUHH3c8jb4O
 letta_client/telemetry/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/telemetry/client.py,sha256=cHMxfLAFjbT-XLtG0o04tGMaRnabrPuixbfHV3HFitE,3042
 letta_client/telemetry/raw_client.py,sha256=Zxs3KkYCfs6M1b4vJbzHunZs7SzSiYAiy4Nb7tFAKC8,4962
-letta_client/templates/__init__.py,sha256=G3ToD1RUnDkj2rZV3M82hiudHSGhcf2XI-EpIzImUMQ,3896
+letta_client/templates/__init__.py,sha256=OxELqtiAhQ5iCAQ--vMrggjS0nWGFSGs_M6Vi901brw,4020
 letta_client/templates/agents/__init__.py,sha256=Nb3AeDuJhSba_DbgHKuCUY1b3PT1jj3-YMJ7uW7RIAk,393
 letta_client/templates/agents/client.py,sha256=HCCEZZ3b0tGonxDNbiPuXadoZu_x1G_OtBdTHRBpG4M,7088
 letta_client/templates/agents/raw_client.py,sha256=RGf_8ZaBbkS3sE7qrKqirL8Mu-E7CDRZNEKFWCJ3v4E,9552
@@ -210,12 +212,13 @@ letta_client/templates/agents/types/agents_create_request_initial_message_sequen
 letta_client/templates/agents/types/agents_create_response.py,sha256=P5sppbD_qW7I9suv5Ykm7tlgnh5a3omYggA8JgLw2RY,637
 letta_client/templates/client.py,sha256=jSMC0kubRHe5hsrozDYJqnQW6nPPEX4W2fOkHmABnwk,27533
 letta_client/templates/raw_client.py,sha256=UHqX47RgBL3hDl-Tq_OKLl_6g1FfiyOJg3gTTRPTMkY,44444
-letta_client/templates/types/__init__.py,sha256=gbQnd4ODVSObpyIJGiJ2n8EY1TgYpDbeq6hphxhysJY,5670
+letta_client/templates/types/__init__.py,sha256=YMsQMFGpYXxp6NBFIdutomxq-dPtmOgfnQrXta_Ap_A,5875
 letta_client/templates/types/templates_create_template_response.py,sha256=UKaNiwW7WNX4Q3_IqGkFJaatMcdSS-Tsf8gDT2i677w,1082
 letta_client/templates/types/templates_delete_template_response.py,sha256=_DUyWh9jtgw8u_U_JsV8N-RhPcY32QLAQZsUCSXDCTY,583
 letta_client/templates/types/templates_fork_template_response.py,sha256=zX8aCR5Z8sEgXJHHzxsPeYRNMW2HfD26EN5Mlwrt-ZI,1080
 letta_client/templates/types/templates_get_template_snapshot_response.py,sha256=75kEOy6l8d1uboqVYHbOWUHk6Ij8pzQ_TmmEe5wEf0c,1295
-letta_client/templates/types/templates_get_template_snapshot_response_agents_item.py,sha256=ciczqvGIPMcuZCu3ObpVAZh8u_cDWbY6ImApwBOK6lc,2567
+letta_client/templates/types/templates_get_template_snapshot_response_agents_item.py,sha256=yRPXQ1XtubMo277RjQFhdD1oI1PqkOUaUfC8HIj_rJg,2858
+letta_client/templates/types/templates_get_template_snapshot_response_agents_item_agent_type.py,sha256=CXbLqt2S21b9bg_wo8r__g-CchjLQ2FqZ7WN-cJAGm8,416
 letta_client/templates/types/templates_get_template_snapshot_response_agents_item_memory_variables.py,sha256=POh1PTstz0UC_rOnkpEyIQI0yHrANeM6Y5vuJlJAruU,877
 letta_client/templates/types/templates_get_template_snapshot_response_agents_item_memory_variables_data_item.py,sha256=TNgE_92wCm2MEGERb_q24_GKzvbh1z1I3pchuwowowA,816
 letta_client/templates/types/templates_get_template_snapshot_response_agents_item_properties.py,sha256=9s-Abzd4QfGjeOyzrdwrPLad4mZx7z4cvX7aOKbeyHs,1084
@@ -232,7 +235,7 @@ letta_client/templates/types/templates_get_template_snapshot_response_agents_ite
 letta_client/templates/types/templates_get_template_snapshot_response_agents_item_tool_variables.py,sha256=P4F5i-3Oum79uzNmn_oM7dkkYj66eVSxCG5MtmCY0nM,869
 letta_client/templates/types/templates_get_template_snapshot_response_agents_item_tool_variables_data_item.py,sha256=DA0m9nJ_6p5Uwx-jbGbxnmqev3jlXo6t2T_BdLTi--s,814
 letta_client/templates/types/templates_get_template_snapshot_response_blocks_item.py,sha256=rODpkefuRh8p2l3mtkh5_3MFovMkCg8CrDCMWOSNXCE,946
-letta_client/templates/types/templates_get_template_snapshot_response_configuration.py,sha256=c3KhXD7IG5j5dzrviH3l3RqU8Xfz6s9F4RQ0ePNpBs4,1567
+letta_client/templates/types/templates_get_template_snapshot_response_configuration.py,sha256=gWk3DPp9NEUX5B6g_wTT3FBcgiRdPMMXf3GXU_nEGtI,1594
 letta_client/templates/types/templates_get_template_snapshot_response_type.py,sha256=DuJQ1O1qoSE3NDwlwXmpz6BiNC5nZ0HeuHFp3M93JBM,269
 letta_client/templates/types/templates_list_request_sort_by.py,sha256=SFmh-eLa14nEUMsv_cF7mm_WyqN-ZVO_Ok8Us6g8sXU,178
 letta_client/templates/types/templates_list_response.py,sha256=M2vTXGuqbQBEsh-lO0OWLRaYk5VgWD7pUTfOeERAyXk,729
@@ -255,7 +258,7 @@ letta_client/tools/types/streaming_response.py,sha256=V1qT-XAqm-z7zffJ7W1JKPCaxZ
 letta_client/tools/types/test_mcp_server_request.py,sha256=3SqjEL3EYi7iV57TjTIzuBSKv8O3Y7qSUFrCiXEvSRk,373
 letta_client/tools/types/update_mcp_server_request.py,sha256=MHouV3iyZCTROguOQP5rOYvnmvDbBeXe5VtEejRvrEs,403
 letta_client/tools/types/update_mcp_server_response.py,sha256=BJTPHWkb8hwgd4FvftQ8eZjl2QzCQT-vZAUVnLft9hw,376
-letta_client/types/__init__.py,sha256=P_vKYIsnDYKlOrTtXSg3Gc4ry6c4VdeHQ72Qf0PBq0Q,29971
+letta_client/types/__init__.py,sha256=cfMGE-4qetwMMogQPqIgUvdx3HTAVRQ3m8GNT7dczlw,30185
 letta_client/types/action_model.py,sha256=VTXavHB6J2d4MjjTMEpkuEyVaiTHyj1FGfa4j8kN6hQ,1241
 letta_client/types/action_parameters_model.py,sha256=s1mJ4tycms8UmCFsxyjKr6RbghSuqv35xpa9mK42sjg,829
 letta_client/types/action_response_model.py,sha256=LcML150OvsKimVV3sP4jSFh8pVxQXn_r_ff8DADOr3c,825
@@ -272,6 +275,8 @@ letta_client/types/app_model.py,sha256=6QlEj1uFSnUMDEkmM1XF1umO-X6AHq5oBGzVTZeZe
 letta_client/types/approval_create.py,sha256=cB5zRgOYzcyAM_ZTKELeCy8SIWTzPQUNcMd1uLjXB_I,1092
 letta_client/types/approval_request_message.py,sha256=goqIU7BQEdOy5DEurCmtdROCxWWjw8BM4938bgUhS5w,1499
 letta_client/types/approval_response_message.py,sha256=mtY_Je8CEOeO78-dcg0aSG3mqRx9afIe_xqcrJcLBDs,1846
+letta_client/types/archival_memory_search_response.py,sha256=zMvo5jJPTxRWW9Cq6d5dsacG9k4LoFcyBCfD_pLe4kg,852
+letta_client/types/archival_memory_search_result.py,sha256=UlAWvWw1YGKAhLfAZZ30-oHLL1oDXFkaXBEAfNkQs3s,926
 letta_client/types/assistant_message.py,sha256=iFCIXRIndpEfBpdv5jX1IMBOWKJsciQF12lfB4I9bHI,1631
 letta_client/types/assistant_message_content.py,sha256=rJZePqcZN74tqx-FbArUF1FaqvATOYAn87mvdpqyINA,242
 letta_client/types/audio.py,sha256=1HlHjJ1FEv4J5G4jQY24G0H91T5LT3K6e-dnQ1Di7i8,549
@@ -575,6 +580,6 @@ letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
 letta_client/voice/__init__.py,sha256=_VhToAyIt_5axN6CLJwtxg3-CO7THa_23pbUzqhXJa4,85
 letta_client/voice/client.py,sha256=EbIVOQh4HXqU9McATxwga08STk-HUwPEAUr_UHqyKHg,3748
 letta_client/voice/raw_client.py,sha256=KvM_3GXuSf51bubM0RVBnxvlf20qZTFMnaA_BzhXzjQ,5938
-letta_client-0.1.305.dist-info/METADATA,sha256=-VzjO3lRc7FdtN-p-GDEbLbRhnfAsCMrZFfRqMvDzYw,5782
-letta_client-0.1.305.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.305.dist-info/RECORD,,
+letta_client-0.1.307.dist-info/METADATA,sha256=RlrUsBamy-O5VpgLvGZlv3uyUe4FKqWoArAayHAV66Q,5782
+letta_client-0.1.307.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.307.dist-info/RECORD,,