letta-client 1.0.0a13__tar.gz → 1.0.0a15__tar.gz

letta_client-1.0.0a15/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.0-alpha.15"
+}

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 1.0.0-alpha.15 (2025-11-04)
+
+Full Changelog: [v1.0.0-alpha.14...v1.0.0-alpha.15](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.14...v1.0.0-alpha.15)
+
+### Features
+
+* add `EventMessage` and `SummaryMessage` ([543571c](https://github.com/letta-ai/letta-python/commit/543571ccdfd7f416c7ed4aca44007155019ed424))
+* add input option to send message route [LET-4540] ([566914d](https://github.com/letta-ai/letta-python/commit/566914db30baedd9354813fccc48dd17483a98e8))
+* make sure tool return chars within max int range ([4c90f6d](https://github.com/letta-ai/letta-python/commit/4c90f6dacfe214aede582881c264fbad5f5bc99c))
+
+## 1.0.0-alpha.14 (2025-11-04)
+
+Full Changelog: [v1.0.0-alpha.13...v1.0.0-alpha.14](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.13...v1.0.0-alpha.14)
+
+### Features
+
+* add new project id header to stainless client ([144fd56](https://github.com/letta-ai/letta-python/commit/144fd562594a87620b4e17ad85cade425ae2391d))
+
+
+### Bug Fixes
+
+* enable stainless pagination ([f4f5744](https://github.com/letta-ai/letta-python/commit/f4f574416331aeb6b48e929b5d589417d14a3c7b))
+
+
+### Chores
+
+* **internal:** grammar fix (it's -> its) ([d8f60b1](https://github.com/letta-ai/letta-python/commit/d8f60b16cd7fc47cbaddcb8de057a25ff7731fae))
+* update stainless templates route to not pass in project id ([a0ba998](https://github.com/letta-ai/letta-python/commit/a0ba9981d73b13a7e5c2995691679696daeae9b6))
+
 ## 1.0.0-alpha.13 (2025-11-03)
 
 Full Changelog: [v1.0.0-alpha.12...v1.0.0-alpha.13](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.12...v1.0.0-alpha.13)

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letta-client
-Version: 1.0.0a13
+Version: 1.0.0a15
 Summary: The official Python library for the letta API
 Project-URL: Homepage, https://github.com/letta-ai/letta-python
 Project-URL: Repository, https://github.com/letta-ai/letta-python

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/api.md

@@ -177,7 +177,7 @@ from letta_client.types.agents import FileListResponse, FileCloseAllResponse, Fi
 
 Methods:
 
-- <code title="get /v1/agents/{agent_id}/files">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">list</a>(agent_id, \*\*<a href="src/letta_client/types/agents/file_list_params.py">params</a>) -> <a href="./src/letta_client/types/agents/file_list_response.py">FileListResponse</a></code>
+- <code title="get /v1/agents/{agent_id}/files">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">list</a>(agent_id, \*\*<a href="src/letta_client/types/agents/file_list_params.py">params</a>) -> <a href="./src/letta_client/types/agents/file_list_response.py">SyncNextFilesPage[FileListResponse]</a></code>
 - <code title="patch /v1/agents/{agent_id}/files/{file_id}/close">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">close</a>(file_id, \*, agent_id) -> object</code>
 - <code title="patch /v1/agents/{agent_id}/files/close-all">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">close_all</a>(agent_id) -> <a href="./src/letta_client/types/agents/file_close_all_response.py">FileCloseAllResponse</a></code>
 - <code title="patch /v1/agents/{agent_id}/files/{file_id}/open">client.agents.files.<a href="./src/letta_client/resources/agents/files.py">open</a>(file_id, \*, agent_id) -> <a href="./src/letta_client/types/agents/file_open_response.py">FileOpenResponse</a></code>
@@ -214,6 +214,7 @@ from letta_client.types.agents import (
     ApprovalRequestMessage,
     ApprovalResponseMessage,
     AssistantMessage,
+    EventMessage,
     HiddenReasoningMessage,
     ImageContent,
     JobStatus,
@@ -233,6 +234,7 @@ from letta_client.types.agents import (
     ReasoningMessage,
     RedactedReasoningContent,
     Run,
+    SummaryMessage,
     SystemMessage,
     TextContent,
     ToolCall,
@@ -531,7 +533,7 @@ Methods:
 
 Methods:
 
-- <code title="post /v1/templates/{project_id}/{template_version}/agents">client.templates.agents.<a href="./src/letta_client/resources/templates/agents.py">create</a>(template_version, \*, project_id, \*\*<a href="src/letta_client/types/templates/agent_create_params.py">params</a>) -> None</code>
+- <code title="post /v1/templates/{template_version}/agents">client.templates.agents.<a href="./src/letta_client/resources/templates/agents.py">create</a>(template_version, \*\*<a href="src/letta_client/types/templates/agent_create_params.py">params</a>) -> None</code>
 
 # McpServers
 

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "letta-client"
-version = "1.0.0-alpha.13"
+version = "1.0.0-alpha.15"
 description = "The official Python library for the letta API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/src/letta_client/_client.py

@@ -91,6 +91,7 @@ class Letta(SyncAPIClient):
     # client options
     api_key: str
     project_id: str | None
+    project: str | None
 
     _environment: Literal["cloud", "local"] | NotGiven
 
@@ -99,6 +100,7 @@ class Letta(SyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["cloud", "local"] | NotGiven = not_given,
         base_url: str | httpx.URL | None | NotGiven = not_given,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -133,6 +135,8 @@ class Letta(SyncAPIClient):
 
         self.project_id = project_id
 
+        self.project = project
+
         self._environment = environment
 
         base_url_env = os.environ.get("LETTA_BASE_URL")
@@ -206,7 +210,8 @@ class Letta(SyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": "false",
-            "X-Project": self.project_id if self.project_id is not None else Omit(),
+            "X-Project-Id": self.project_id if self.project_id is not None else Omit(),
+            "X-Project": self.project if self.project is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -215,6 +220,7 @@ class Letta(SyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["cloud", "local"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -251,6 +257,7 @@ class Letta(SyncAPIClient):
         return self.__class__(
             api_key=api_key or self.api_key,
             project_id=project_id or self.project_id,
+            project=project or self.project,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -339,6 +346,7 @@ class AsyncLetta(AsyncAPIClient):
     # client options
     api_key: str
     project_id: str | None
+    project: str | None
 
     _environment: Literal["cloud", "local"] | NotGiven
 
@@ -347,6 +355,7 @@ class AsyncLetta(AsyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["cloud", "local"] | NotGiven = not_given,
         base_url: str | httpx.URL | None | NotGiven = not_given,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -381,6 +390,8 @@ class AsyncLetta(AsyncAPIClient):
 
         self.project_id = project_id
 
+        self.project = project
+
         self._environment = environment
 
         base_url_env = os.environ.get("LETTA_BASE_URL")
@@ -454,7 +465,8 @@ class AsyncLetta(AsyncAPIClient):
         return {
             **super().default_headers,
             "X-Stainless-Async": f"async:{get_async_library()}",
-            "X-Project": self.project_id if self.project_id is not None else Omit(),
+            "X-Project-Id": self.project_id if self.project_id is not None else Omit(),
+            "X-Project": self.project if self.project is not None else Omit(),
             **self._custom_headers,
         }
 
@@ -463,6 +475,7 @@ class AsyncLetta(AsyncAPIClient):
         *,
         api_key: str | None = None,
         project_id: str | None = None,
+        project: str | None = None,
         environment: Literal["cloud", "local"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = not_given,
@@ -499,6 +512,7 @@ class AsyncLetta(AsyncAPIClient):
         return self.__class__(
             api_key=api_key or self.api_key,
             project_id=project_id or self.project_id,
+            project=project or self.project,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/src/letta_client/_utils/_utils.py

@@ -133,7 +133,7 @@ def is_given(obj: _T | NotGiven | Omit) -> TypeGuard[_T]:
 # Type safe methods for narrowing types with TypeVars.
 # The default narrowing for isinstance(obj, dict) is dict[unknown, unknown],
 # however this cause Pyright to rightfully report errors. As we know we don't
-# care about the contained types we can safely use `object` in it's place.
+# care about the contained types we can safely use `object` in its place.
 #
 # There are two separate functions defined, `is_*` and `is_*_t` for different use cases.
 # `is_*` is for when you're dealing with an unknown input

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/src/letta_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "letta_client"
-__version__ = "1.0.0-alpha.13"  # x-release-please-version
+__version__ = "1.0.0-alpha.15"  # x-release-please-version

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/src/letta_client/pagination.py

@@ -35,7 +35,7 @@ class ObjectPageItem(Protocol):
 
 @runtime_checkable
 class NextFilesPageItem(Protocol):
-    next_cursor: Optional[str]
+    id: Optional[str]
 
 
 class SyncArrayPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
@@ -222,18 +222,18 @@ class SyncNextFilesPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
 
         if is_forwards:
             item = cast(Any, files[-1])
-            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+            if not isinstance(item, NextFilesPageItem) or item.id is None:
                 # TODO emit warning log
                 return None
 
-            return PageInfo(params={"after": item.next_cursor})
+            return PageInfo(params={"after": item.id})
         else:
             item = cast(Any, self.files[0])
-            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+            if not isinstance(item, NextFilesPageItem) or item.id is None:
                 # TODO emit warning log
                 return None
 
-            return PageInfo(params={"before": item.next_cursor})
+            return PageInfo(params={"before": item.id})
 
 
 class AsyncNextFilesPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
@@ -266,15 +266,15 @@ class AsyncNextFilesPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
 
         if is_forwards:
             item = cast(Any, files[-1])
-            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+            if not isinstance(item, NextFilesPageItem) or item.id is None:
                 # TODO emit warning log
                 return None
 
-            return PageInfo(params={"after": item.next_cursor})
+            return PageInfo(params={"after": item.id})
         else:
             item = cast(Any, self.files[0])
-            if not isinstance(item, NextFilesPageItem) or item.next_cursor is None:
+            if not isinstance(item, NextFilesPageItem) or item.id is None:
                 # TODO emit warning log
                 return None
 
-            return PageInfo(params={"before": item.next_cursor})
+            return PageInfo(params={"before": item.id})

{letta_client-1.0.0a13 → letta_client-1.0.0a15}/src/letta_client/resources/agents/files.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
-from ..._utils import maybe_transform, async_maybe_transform
+from ..._utils import maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
@@ -17,7 +17,8 @@ from ..._response import (
     async_to_raw_response_wrapper,
     async_to_streamed_response_wrapper,
 )
-from ..._base_client import make_request_options
+from ...pagination import SyncNextFilesPage, AsyncNextFilesPage
+from ..._base_client import AsyncPaginator, make_request_options
 from ...types.agents import file_list_params
 from ...types.agents.file_list_response import FileListResponse
 from ...types.agents.file_open_response import FileOpenResponse
@@ -63,7 +64,7 @@ class FilesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileListResponse:
+    ) -> SyncNextFilesPage[FileListResponse]:
         """
         Get the files attached to an agent with their open/closed status.
 
@@ -97,8 +98,9 @@ class FilesResource(SyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_id}/files",
+            page=SyncNextFilesPage[FileListResponse],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -117,7 +119,7 @@ class FilesResource(SyncAPIResource):
                     file_list_params.FileListParams,
                 ),
             ),
-            cast_to=FileListResponse,
+            model=FileListResponse,
         )
 
     def close(
@@ -266,7 +268,7 @@ class AsyncFilesResource(AsyncAPIResource):
         """
         return AsyncFilesResourceWithStreamingResponse(self)
 
-    async def list(
+    def list(
         self,
         agent_id: str,
         *,
@@ -283,7 +285,7 @@ class AsyncFilesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileListResponse:
+    ) -> AsyncPaginator[FileListResponse, AsyncNextFilesPage[FileListResponse]]:
         """
         Get the files attached to an agent with their open/closed status.
 
@@ -317,14 +319,15 @@ class AsyncFilesResource(AsyncAPIResource):
         """
         if not agent_id:
             raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._get(
+        return self._get_api_list(
             f"/v1/agents/{agent_id}/files",
+            page=AsyncNextFilesPage[FileListResponse],
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform(
+                query=maybe_transform(
                     {
                         "after": after,
                         "before": before,
@@ -337,7 +340,7 @@ class AsyncFilesResource(AsyncAPIResource):
                     file_list_params.FileListParams,
                 ),
             ),
-            cast_to=FileListResponse,
+            model=FileListResponse,
         )
 
     async def close(