letta-client 0.1.210__py3-none-any.whl → 0.1.212__py3-none-any.whl

letta_client/__init__.py

@@ -93,6 +93,7 @@ from .types import (
     EmbeddingConfigEmbeddingEndpointType,
     FeedbackType,
     File,
+    FileBlock,
     FileFile,
     FileMetadata,
     FileProcessingStatus,
@@ -457,6 +458,7 @@ __all__ = [
     "EmbeddingConfigEmbeddingEndpointType",
     "FeedbackType",
     "File",
+    "FileBlock",
     "FileFile",
     "FileMetadata",
     "FileProcessingStatus",

letta_client/agents/client.py

@@ -1081,6 +1081,137 @@ class AgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    def open_file(
+        self, agent_id: str, file_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[str]:
+        """
+        Opens a specific file for a given agent.
+
+        This endpoint marks a specific file as open in the agent's file state.
+        The file will be included in the agent's working memory view.
+        Returns a list of file names that were closed due to LRU eviction.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        file_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.agents.open_file(
+            agent_id="agent_id",
+            file_id="file_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/files/{jsonable_encoder(file_id)}/open",
+            method="PATCH",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    def close_file(
+        self, agent_id: str, file_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
+        """
+        Closes a specific file for a given agent.
+
+        This endpoint marks a specific file as closed in the agent's file state.
+        The file will be removed from the agent's working memory view.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        file_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            project="YOUR_PROJECT",
+            token="YOUR_TOKEN",
+        )
+        client.agents.close_file(
+            agent_id="agent_id",
+            file_id="file_id",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/files/{jsonable_encoder(file_id)}/close",
+            method="PATCH",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def summarize_agent_conversation(
         self, agent_id: str, *, max_message_length: int, request_options: typing.Optional[RequestOptions] = None
     ) -> AgentState:
@@ -2338,6 +2469,153 @@ class AsyncAgentsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
+    async def open_file(
+        self, agent_id: str, file_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[str]:
+        """
+        Opens a specific file for a given agent.
+
+        This endpoint marks a specific file as open in the agent's file state.
+        The file will be included in the agent's working memory view.
+        Returns a list of file names that were closed due to LRU eviction.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        file_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            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.open_file(
+                agent_id="agent_id",
+                file_id="file_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/files/{jsonable_encoder(file_id)}/open",
+            method="PATCH",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def close_file(
+        self, agent_id: str, file_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.Optional[typing.Any]:
+        """
+        Closes a specific file for a given agent.
+
+        This endpoint marks a specific file as closed in the agent's file state.
+        The file will be removed from the agent's working memory view.
+
+        Parameters
+        ----------
+        agent_id : str
+
+        file_id : str
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Optional[typing.Any]
+            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.close_file(
+                agent_id="agent_id",
+                file_id="file_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/agents/{jsonable_encoder(agent_id)}/files/{jsonable_encoder(file_id)}/close",
+            method="PATCH",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.Optional[typing.Any],
+                    construct_type(
+                        type_=typing.Optional[typing.Any],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    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, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     async def summarize_agent_conversation(
         self, agent_id: str, *, max_message_length: int, request_options: typing.Optional[RequestOptions] = None
     ) -> AgentState:

letta_client/core/client_wrapper.py

@@ -24,7 +24,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.210",
+            "X-Fern-SDK-Version": "0.1.212",
         }
         if self._project is not None:
             headers["X-Project"] = self._project

letta_client/types/__init__.py

@@ -92,6 +92,7 @@ from .embedding_config import EmbeddingConfig
 from .embedding_config_embedding_endpoint_type import EmbeddingConfigEmbeddingEndpointType
 from .feedback_type import FeedbackType
 from .file import File
+from .file_block import FileBlock
 from .file_file import FileFile
 from .file_metadata import FileMetadata
 from .file_processing_status import FileProcessingStatus
@@ -354,6 +355,7 @@ __all__ = [
     "EmbeddingConfigEmbeddingEndpointType",
     "FeedbackType",
     "File",
+    "FileBlock",
     "FileFile",
     "FileMetadata",
     "FileProcessingStatus",

letta_client/types/file_block.py

@@ -0,0 +1,98 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.unchecked_base_model import UncheckedBaseModel
+import pydantic
+import typing
+import datetime as dt
+from ..core.pydantic_utilities import IS_PYDANTIC_V2
+
+
+class FileBlock(UncheckedBaseModel):
+    value: str = pydantic.Field()
+    """
+    Value of the block.
+    """
+
+    limit: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Character limit of the block.
+    """
+
+    name: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Name of the block if it is a template.
+    """
+
+    is_template: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the block is a template (e.g. saved human/persona options).
+    """
+
+    preserve_on_migration: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Preserve the block on template migration.
+    """
+
+    label: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Label of the block (e.g. 'human', 'persona') in the context window.
+    """
+
+    read_only: typing.Optional[bool] = pydantic.Field(default=None)
+    """
+    Whether the agent has read-only access to the block.
+    """
+
+    description: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Description of the block.
+    """
+
+    metadata: typing.Optional[typing.Dict[str, typing.Optional[typing.Any]]] = pydantic.Field(default=None)
+    """
+    Metadata of the block.
+    """
+
+    id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The human-friendly ID of the Block
+    """
+
+    created_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that made this Block.
+    """
+
+    last_updated_by_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    The id of the user that last updated this Block.
+    """
+
+    file_id: str = pydantic.Field()
+    """
+    Unique identifier of the file.
+    """
+
+    source_id: str = pydantic.Field()
+    """
+    Unique identifier of the source (denormalized from files.source_id).
+    """
+
+    is_open: bool = pydantic.Field()
+    """
+    True if the agent currently has the file open.
+    """
+
+    last_accessed_at: typing.Optional[dt.datetime] = pydantic.Field(default=None)
+    """
+    UTC timestamp of the agent’s most recent access to this file.
+    """
+
+    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/memory.py

@@ -4,6 +4,7 @@ from ..core.unchecked_base_model import UncheckedBaseModel
 import typing
 from .block import Block
 import pydantic
+from .file_block import FileBlock
 from ..core.pydantic_utilities import IS_PYDANTIC_V2
 
 
@@ -17,9 +18,9 @@ class Memory(UncheckedBaseModel):
     Memory blocks contained in the agent's in-context memory
     """
 
-    file_blocks: typing.Optional[typing.List[Block]] = pydantic.Field(default=None)
+    file_blocks: typing.Optional[typing.List[FileBlock]] = pydantic.Field(default=None)
     """
-    Blocks representing the agent's in-context memory of an attached file
+    Special blocks representing the agent's in-context memory of an attached file
     """
 
     prompt_template: typing.Optional[str] = pydantic.Field(default=None)

{letta_client-0.1.210.dist-info → letta_client-0.1.212.dist-info}/METADATA

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

{letta_client-0.1.210.dist-info → letta_client-0.1.212.dist-info}/RECORD

@@ -1,8 +1,8 @@
-letta_client/__init__.py,sha256=DpCoPhi5qy7K-MmczqULa30OTff96XkneWc4tYISq_8,19164
+letta_client/__init__.py,sha256=Lr_wx_v6AIGHoA5rwxPfrqDgdWbPjCkZEragpbhMu-U,19196
 letta_client/agents/__init__.py,sha256=i9PmBueIWESDLqmpzWt1oZVgZNr1rNkO6j0pl5sgvGo,2049
 letta_client/agents/blocks/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/blocks/client.py,sha256=4UGPYxfGwNN3ZW-SkIdfVZK6cvCcumVAw0_AM8OmoBY,25046
-letta_client/agents/client.py,sha256=A1hsOq4KNJiZdkOgPA5ceWlsx8W4yCt3S3d2K-ID_i8,96457
+letta_client/agents/client.py,sha256=kldj19HcO2hBnK63JAjjOgvXiFtLPqDJHtLiGH2Jez8,105561
 letta_client/agents/context/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/context/client.py,sha256=O1gxStQyfzXi4MblatWalLTWM425gS_fndW3W_es08U,4887
 letta_client/agents/core_memory/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
@@ -71,7 +71,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=OKbX2aCZXgHCDUsCouqv-OiX32xA6eFFCKIUH9M5Vzk,1591
 letta_client/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-letta_client/core/client_wrapper.py,sha256=dRnRfRWKrdVYSyjvy49jGDWDMuA3oJdNEcelUtNSpoQ,2336
+letta_client/core/client_wrapper.py,sha256=OcgtktK5k9jFFfySjDNcvitkcxcte_EZ5VcYimN-GcY,2336
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/http_client.py,sha256=Z77OIxIbL4OAB2IDqjRq_sYa5yNYAWfmdhdCSSvh6Y4,19552
@@ -168,7 +168,7 @@ letta_client/tools/types/list_mcp_servers_response_value.py,sha256=Eyji5qB7Fhowi
 letta_client/tools/types/test_mcp_server_request.py,sha256=sLlOEZdmLfkHqHCkUjntGbr8_MkBhsqpMQ-HwdNOnq0,372
 letta_client/tools/types/update_mcp_server_request.py,sha256=nCpx9-OvpH0l5iJxEi8kgSok1F1r7liEAZm-kaqBtEo,402
 letta_client/tools/types/update_mcp_server_response.py,sha256=muwHagaQBMwQI0of9EBCBtG9lD-jELFAevgTB2MjpFQ,375
-letta_client/types/__init__.py,sha256=x9wL7fPYikvZZXi2exF3cWIJI4LmXqmHiKW_Dwlj_5g,22803
+letta_client/types/__init__.py,sha256=-5MECfLh1Fp5kO_6_PHwucqqqKlU58hxq1Bz4ssLzvY,22854
 letta_client/types/action_model.py,sha256=y1e2XMv3skFaNJIBdYoBKgiORzGh05aOVvu-qVR9uHg,1240
 letta_client/types/action_parameters_model.py,sha256=LgKf5aPZG3-OHGxFdXiSokIDgce8c02xPYIAY05VgW8,828
 letta_client/types/action_response_model.py,sha256=yq2Fd9UU8j7vvtE3VqXUoRRvDzWcfJPj_95ynGdeHCs,824
@@ -261,6 +261,7 @@ letta_client/types/embedding_config.py,sha256=47DxstNToHfirYxgIn4jNqkt8vDh5taRu6
 letta_client/types/embedding_config_embedding_endpoint_type.py,sha256=Ho1HSODi21PkzsZR58g7FlIMReFU2yf0hAS5OyUsW6Q,559
 letta_client/types/feedback_type.py,sha256=sDfsniSnnpSwzZqfIkRL7vYPxYqdwURpI6LMI7eDkoQ,160
 letta_client/types/file.py,sha256=ZLCEYJqIJ1pzAJn4Pke6gVdKivKU9FrIg98P4GmFY8M,628
+letta_client/types/file_block.py,sha256=-TNvyoN3NPqUtLqwsu8WUhAdCE-_YE3ZTrKHD64CMA0,2619
 letta_client/types/file_file.py,sha256=jbWcPKn-fSUlq9kl8n2us9fPU6x-Z20IKScHD_pJruw,665
 letta_client/types/file_metadata.py,sha256=51abJ_M4dmpRJetdWcMf_P39l3EaJ1R2kjuexzEWwMI,2957
 letta_client/types/file_processing_status.py,sha256=8W8VAx9-jCaUx6q6mvyCMyLoa2peLTE_sgIaGloOWo4,201
@@ -315,7 +316,7 @@ letta_client/types/max_count_per_step_tool_rule.py,sha256=6vBWeGH2FW3ze--lr4DVuq
 letta_client/types/max_count_per_step_tool_rule_schema.py,sha256=1Zq4vblRTqFycqk7cBQ3gVCUy-MPWvE_tNXV5Fz0VTs,618
 letta_client/types/mcp_server_type.py,sha256=cEiRY8zJw3YdV0RV6tt4JUYd0AHT_UNeLgxaouU-_4A,172
 letta_client/types/mcp_tool.py,sha256=CLLpyiyUo0yLWG_ararTJmzzaUYhfANC2dNAhEUfy1Q,1376
-letta_client/types/memory.py,sha256=Fa07vLHBsc4eNK65Yla2zOuzYhtgFGlnPzAGo9GvJ-c,1210
+letta_client/types/memory.py,sha256=Wc8iqhqwBuloA87abtGF1Y5ncyCL2vjKUp45Fi-vRoY,1256
 letta_client/types/message.py,sha256=v5x-ykNKmgVSzQkE9w71nxq4RfrgILCciSKA2sHD_Q4,4734
 letta_client/types/message_content_item.py,sha256=FrwERKfU5MpV4Y8LC5ejKFkoqqSV_Ooww-r32VGBbME,629
 letta_client/types/message_create.py,sha256=jgtA2pi59E7Pv37oyGO51wjZyRtfxVpgENXad8fxQqM,1601
@@ -428,6 +429,6 @@ letta_client/types/web_search_options_user_location_approximate.py,sha256=Ywk01J
 letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
 letta_client/voice/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/voice/client.py,sha256=47iQYCuW_qpKI4hM3pYVxn3hw7kgQj3emU1_oRpkRMA,5811
-letta_client-0.1.210.dist-info/METADATA,sha256=USzjF6PiIRSoqX4fr9Pxf9xmxncgm_rD4gpj2vgob8Y,5177
-letta_client-0.1.210.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.210.dist-info/RECORD,,
+letta_client-0.1.212.dist-info/METADATA,sha256=W9ETbo2ao68n8iTEZ8T8cxKkp9SWLkqsUtNeLyhXgAw,5177
+letta_client-0.1.212.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.212.dist-info/RECORD,,