letta-client 0.1.305__tar.gz → 0.1.306__tar.gz

{letta_client-0.1.305 → letta_client-0.1.306}/PKG-INFO

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

{letta_client-0.1.305 → letta_client-0.1.306}/pyproject.toml

@@ -3,7 +3,7 @@ name = "letta-client"
 
 [tool.poetry]
 name = "letta-client"
-version = "0.1.305"
+version = "0.1.306"
 description = ""
 readme = "README.md"
 authors = []

{letta_client-0.1.305 → letta_client-0.1.306}/src/letta_client/__init__.py

@@ -19,6 +19,8 @@ from .types import (
     ApprovalCreate,
     ApprovalRequestMessage,
     ApprovalResponseMessage,
+    ArchivalMemorySearchResponse,
+    ArchivalMemorySearchResult,
     AssistantMessage,
     AssistantMessageContent,
     Audio,
@@ -452,6 +454,8 @@ __all__ = [
     "ApprovalCreate",
     "ApprovalRequestMessage",
     "ApprovalResponseMessage",
+    "ArchivalMemorySearchResponse",
+    "ArchivalMemorySearchResult",
     "AssistantMessage",
     "AssistantMessageContent",
     "AsyncLetta",

{letta_client-0.1.305 → letta_client-0.1.306}/src/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-0.1.306/src/letta_client/agents/passages/__init__.py

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

{letta_client-0.1.305 → letta_client-0.1.306}/src/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-0.1.305 → letta_client-0.1.306}/src/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-0.1.306/src/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-0.1.306/src/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-0.1.305 → letta_client-0.1.306}/src/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.306",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.305",
+            "X-Fern-SDK-Version": "0.1.306",
             **(self.get_custom_headers() or {}),
         }
         if self._project is not None:

{letta_client-0.1.305 → letta_client-0.1.306}/src/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-0.1.306/src/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-0.1.306/src/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/src/letta_client/voice/__init__.py

@@ -1,4 +0,0 @@
-# This file was auto-generated by Fern from our API Definition.
-
-# isort: skip_file
-