letta-client 1.0.0a19__tar.gz → 1.6.0__tar.gz

letta_client-1.6.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.6.0"
+}

{letta_client-1.0.0a19 → letta_client-1.6.0}/CHANGELOG.md

@@ -1,5 +1,232 @@
 # Changelog
 
+## 1.6.0 (2025-12-18)
+
+Full Changelog: [v1.5.0...v1.6.0](https://github.com/letta-ai/letta-python/compare/v1.5.0...v1.6.0)
+
+### Features
+
+* add compaction response ([2b34802](https://github.com/letta-ai/letta-python/commit/2b348028c316f56d691bcc94595283b05e4c0749))
+
+## 1.5.0 (2025-12-18)
+
+Full Changelog: [v1.4.0...v1.5.0](https://github.com/letta-ai/letta-python/compare/v1.4.0...v1.5.0)
+
+### Features
+
+* add msg id to search endpoint response ([43669d7](https://github.com/letta-ai/letta-python/commit/43669d76a38274d41e0fe7b37608d728b6925829))
+* allow for configuration compaction and return message delta ([203f65e](https://github.com/letta-ai/letta-python/commit/203f65e469c3c44c85eb212f1bdc5c86e1538ed9))
+
+
+### Bug Fixes
+
+* use async_to_httpx_files in patch method ([a0095bb](https://github.com/letta-ai/letta-python/commit/a0095bb7bc4c525edc406c8be58ae34f2968d0aa))
+
+
+### Chores
+
+* speedup initial import ([a4a4f90](https://github.com/letta-ai/letta-python/commit/a4a4f90bf8d8e6de1796963181b0ba2d2cf8a9bd))
+
+## 1.4.0 (2025-12-15)
+
+Full Changelog: [v1.3.3...v1.4.0](https://github.com/letta-ai/letta-python/compare/v1.3.3...v1.4.0)
+
+### Features
+
+* add  `agent_id` to search results ([3d78133](https://github.com/letta-ai/letta-python/commit/3d78133291ee4ed9b77b0f0b5af1f0f7a537cb84))
+* add `compaction_settings` to agents ([42b5520](https://github.com/letta-ai/letta-python/commit/42b5520152785d0b70d6709e4bd1dd6808884d8e))
+* Add max tokens exceeded to stop reasons [LET-6480] ([1c09fbc](https://github.com/letta-ai/letta-python/commit/1c09fbc41f24332a5f89cda9149aa0254d0957e3))
+* add project id scoping backend changes ([a8cbf43](https://github.com/letta-ai/letta-python/commit/a8cbf4366da627d1e18dfeed2911847381e8c90f))
+* refactor summarization and message persistence code ([91165d8](https://github.com/letta-ai/letta-python/commit/91165d808b072441aa06f6dad03b3560c537698c))
+
+
+### Bug Fixes
+
+* fix `prompt_acknowledgement` usage ([eb72984](https://github.com/letta-ai/letta-python/commit/eb72984c95c48e653e3c9b4037b5841dc07dca65))
+* **types:** allow pyright to infer TypedDict types within SequenceNotStr ([b2d9116](https://github.com/letta-ai/letta-python/commit/b2d9116b07e59511c33aa8e288c9b0b0bbed1823))
+* use `model` instead of `model_settings` ([07c1bdc](https://github.com/letta-ai/letta-python/commit/07c1bdc08cda66c8b4a6de37ef0a553948e04ece))
+
+
+### Chores
+
+* add missing docstrings ([f40eef6](https://github.com/letta-ai/letta-python/commit/f40eef68197f582ca96dc6d9e3234c30e8e3d12a))
+* **docs:** use environment variables for authentication in code snippets ([826753b](https://github.com/letta-ai/letta-python/commit/826753bdc8efe7a56f72046a6d9b1ed10d7dbdfd))
+* **internal:** add missing files argument to base client ([3c49896](https://github.com/letta-ai/letta-python/commit/3c49896c8eec32865f40d406c73922db315b1cd3))
+
+## 1.3.3 (2025-12-02)
+
+Full Changelog: [v1.3.2...v1.3.3](https://github.com/letta-ai/letta-python/compare/v1.3.2...v1.3.3)
+
+### Chores
+
+* add letta source header ([#58](https://github.com/letta-ai/letta-python/issues/58)) ([51c6027](https://github.com/letta-ai/letta-python/commit/51c6027b976b17146f25eab52d9442cbe5e3cfa9))
+* add passages convenience sdk methods to agents route ([f515461](https://github.com/letta-ai/letta-python/commit/f5154617a6dfe9c5fcd5aee0e3604470182813e9))
+* update lockfile ([e57249f](https://github.com/letta-ai/letta-python/commit/e57249ff2a30fdbaeba9fd160be44bc1398dec6d))
+
+## 1.3.2 (2025-12-01)
+
+Full Changelog: [v1.3.1...v1.3.2](https://github.com/letta-ai/letta-python/compare/v1.3.1...v1.3.2)
+
+### Features
+
+* add delete/create template endpoint ([b3fb93d](https://github.com/letta-ai/letta-python/commit/b3fb93de1b3eb063c02b3d6fdb13df14169d0993))
+* add tracking of advanced usage data (eg caching) [LET-6372] ([eca8dda](https://github.com/letta-ai/letta-python/commit/eca8dda6ab5583ae560e3e714fd5d20f83dabfc7))
+
+
+### Bug Fixes
+
+* **core:** distinguish between null and 0 for prompt caching ([00a938f](https://github.com/letta-ai/letta-python/commit/00a938f9b6b92f7330683913701f67cf2ace6e87))
+* ensure streams are always closed ([7efff66](https://github.com/letta-ai/letta-python/commit/7efff66b0da512182aab0f19e007128d39b08ba5))
+* remove project_id from identities list ([77dee4b](https://github.com/letta-ai/letta-python/commit/77dee4b26fcafdc85beb179ae7d34e4ec7ed45bc))
+* remove upsert base tools from sdk ([665ce21](https://github.com/letta-ai/letta-python/commit/665ce21a49cbf9ddc221d014bb84514d376fa19e))
+
+
+### Chores
+
+* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([3468c79](https://github.com/letta-ai/letta-python/commit/3468c7933fe85faf6348ef26f25666df8b26060f))
+* update endpoints ([693d7c9](https://github.com/letta-ai/letta-python/commit/693d7c97ffa94f16eb7f2a33fb6c10dd33078eed))
+
+## 1.3.1 (2025-11-26)
+
+Full Changelog: [v1.3.0...v1.3.1](https://github.com/letta-ai/letta-python/compare/v1.3.0...v1.3.1)
+
+### Features
+
+* Fix template alignment ([0380268](https://github.com/letta-ai/letta-python/commit/0380268aab9df514c7d0948e9c31b63953d7b249))
+* query param validation block label, name, and search ([9559f56](https://github.com/letta-ai/letta-python/commit/9559f56e0374603ff3977ee6952b3fb691ab9163))
+* run tool by  for a given agent ([4706b60](https://github.com/letta-ai/letta-python/commit/4706b6010115f3a89c82674d40ce7277663c332b))
+* Shub/let 6339 add endpoint for counting non hidden agents [LET-6339] ([cfee192](https://github.com/letta-ai/letta-python/commit/cfee1925329419dfd1f2f65b6e47b74bc24781de))
+* structured outputs for anthropic ([7dd7254](https://github.com/letta-ai/letta-python/commit/7dd72547133d23e171c6bf9d27d54631a10eb144))
+* structured outputs for openai [LET-6233] ([96e56fa](https://github.com/letta-ai/letta-python/commit/96e56fa56612e293d8b7beef6e3d74a216ea07f2))
+
+
+### Chores
+
+* add tools search to stainless ([e1dfa06](https://github.com/letta-ai/letta-python/commit/e1dfa064626578158483db163d511af7f153d921))
+
+## 1.3.0 (2025-11-25)
+
+Full Changelog: [v1.2.0...v1.3.0](https://github.com/letta-ai/letta-python/compare/v1.2.0...v1.3.0)
+
+### Features
+
+* add messages + passages to stainless.yml ([44aac08](https://github.com/letta-ai/letta-python/commit/44aac08d1d31a4fa1cb7f805dd5de9744c674daa))
+
+
+### Chores
+
+* use main branch in sdk repos ([b71fff8](https://github.com/letta-ai/letta-python/commit/b71fff88a4c194f478fe3e5fc0ac1430607c1947))
+
+## 1.2.0 (2025-11-25)
+
+Full Changelog: [v1.1.2...v1.2.0](https://github.com/letta-ai/letta-python/compare/v1.1.2...v1.2.0)
+
+### Features
+
+* add search routes ([71094b3](https://github.com/letta-ai/letta-python/commit/71094b371fc636bdc3a8956ce36793b8218a96e0))
+* add support for new model ([03a1d2d](https://github.com/letta-ai/letta-python/commit/03a1d2d9c7fc4b3ba4b7aa14020c3ef5118d5506))
+
+
+### Bug Fixes
+
+* disable messages + passages for now ([f6c4e54](https://github.com/letta-ai/letta-python/commit/f6c4e545e0eac72f03829cfd08da2e8dfa37b2b0))
+* properly limit runs query ([eccc942](https://github.com/letta-ai/letta-python/commit/eccc942c424192fed7993024b88edb37b130e434))
+
+
+### Chores
+
+* add Python 3.14 classifier and testing ([4d3c6e8](https://github.com/letta-ai/letta-python/commit/4d3c6e851c009dcb1aa667e459df4788cadf050b))
+
+## 1.1.2 (2025-11-21)
+
+Full Changelog: [v1.1.1...v1.1.2](https://github.com/letta-ai/letta-python/compare/v1.1.1...v1.1.2)
+
+### Bug Fixes
+
+* api key not optional for stainless sdk ([6ef0456](https://github.com/letta-ai/letta-python/commit/6ef04566b0e8a0924132684ab22d0a96620f2e28))
+
+## 1.1.1 (2025-11-21)
+
+Full Changelog: [v1.1.0...v1.1.1](https://github.com/letta-ai/letta-python/compare/v1.1.0...v1.1.1)
+
+### Features
+
+* parallel tool calling in model settings ([d9fb097](https://github.com/letta-ai/letta-python/commit/d9fb0970aff1e28599f0ed14a69db2127919ce00))
+
+
+### Bug Fixes
+
+* create agent for template openapi response schema ([adb1515](https://github.com/letta-ai/letta-python/commit/adb151525142f77e4fcd1331cf8e5e0a17e20f87))
+
+## 1.1.0 (2025-11-20)
+
+Full Changelog: [v1.0.0...v1.1.0](https://github.com/letta-ai/letta-python/compare/v1.0.0...v1.1.0)
+
+### Features
+
+* add new letta error message stream response type ([dfa5f65](https://github.com/letta-ai/letta-python/commit/dfa5f6577d26e9b0ad684ebb9123cbbd1637f06d))
+* rename upsert properties endpoint ([7764513](https://github.com/letta-ai/letta-python/commit/7764513a9cf431e4ee97e2e63e11804de480f06f))
+
+## 1.0.0 (2025-11-19)
+
+Full Changelog: [v1.0.0-alpha.22...v1.0.0](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.22...v1.0.0)
+
+### Features
+
+* add client side access tokens to stainless ([770bfdb](https://github.com/letta-ai/letta-python/commit/770bfdbbd9e77ce0d305295f8c081ca03e6971c0))
+* hack at gpt51 [LET-6178] ([d93a58c](https://github.com/letta-ai/letta-python/commit/d93a58c390c7995cecd890667c76d393dd8834b8))
+* Revert "feat: support anthropic structured outputs [LET-6190]" ([e3aed33](https://github.com/letta-ai/letta-python/commit/e3aed33178bf71fa15e5e739a908cb5bc85d03f4))
+
+## 1.0.0-alpha.22 (2025-11-18)
+
+Full Changelog: [v1.0.0-alpha.21...v1.0.0-alpha.22](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.21...v1.0.0-alpha.22)
+
+### Features
+
+* make config for mcp_servers and messages.modify nested ([8d9ec52](https://github.com/letta-ai/letta-python/commit/8d9ec52526ede5a82bc950bce56937dba1c2ac1a))
+
+
+### Bug Fixes
+
+* make attach/detach routes return None if sdk verion 1.0 ([c8496f1](https://github.com/letta-ai/letta-python/commit/c8496f1fb953b75bc08ea4bbcf61884d5a50c747))
+
+## 1.0.0-alpha.21 (2025-11-17)
+
+Full Changelog: [v1.0.0-alpha.20...v1.0.0-alpha.21](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.20...v1.0.0-alpha.21)
+
+### Features
+
+* make attach/detach routes return None if version is 1.0 [LET-5844] ([799aa31](https://github.com/letta-ai/letta-python/commit/799aa31b7124a3d9841d3153aff09457d47bded6))
+* move sources to folders ([4b86f41](https://github.com/letta-ai/letta-python/commit/4b86f41014ad19c7751039ad718f7ed3542c8d1a))
+* rename .af parameters [LET-6154] ([90c47e6](https://github.com/letta-ai/letta-python/commit/90c47e6d4bb58e9054c8c63f1707bff086165d06))
+* Revert "feat: make attach/detach routes return None if version is 1.0 [LET-5844]" ([417acb3](https://github.com/letta-ai/letta-python/commit/417acb3c34d6da398a9feb0a2c247f6062703277))
+* support anthropic structured outputs [LET-6190] ([626a22c](https://github.com/letta-ai/letta-python/commit/626a22c4ebc3030072155b84e4c8cb4062a9dae3))
+
+
+### Chores
+
+* remove mcp-servers connect for stainless [LET-6166] ([9f1072b](https://github.com/letta-ai/letta-python/commit/9f1072b5998452ac8fd376bf36729c50981e98ba))
+* rename summarize to compact in sdk ([48a3217](https://github.com/letta-ai/letta-python/commit/48a32175cf56f655b02cc25fc62b2861ed2def8d))
+
+## 1.0.0-alpha.20 (2025-11-12)
+
+Full Changelog: [v1.0.0-alpha.19...v1.0.0-alpha.20](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.19...v1.0.0-alpha.20)
+
+### Features
+
+* deprecate `EmbeddingConfig` from archives ([d6cbbc3](https://github.com/letta-ai/letta-python/commit/d6cbbc39933572367b06194c87affcf35d2c38f6))
+
+
+### Bug Fixes
+
+* **compat:** update signatures of `model_dump` and `model_dump_json` for Pydantic v1 ([4724b32](https://github.com/letta-ai/letta-python/commit/4724b328a03756d769f38f5939604131a67ac83d))
+
+
+### Chores
+
+* rename send to create and modify to update ([c8e0661](https://github.com/letta-ai/letta-python/commit/c8e0661e694c3511239e806bffba3ef7cda69d25))
+* update stainless send to create ([7f55f59](https://github.com/letta-ai/letta-python/commit/7f55f59807e6a2483ce7ae38bff92f16eb40b5b4))
+
 ## 1.0.0-alpha.19 (2025-11-12)
 
 Full Changelog: [v1.0.0-alpha.18...v1.0.0-alpha.19](https://github.com/letta-ai/letta-python/compare/v1.0.0-alpha.18...v1.0.0-alpha.19)

{letta_client-1.0.0a19 → letta_client-1.6.0}/CONTRIBUTING.md

@@ -62,7 +62,7 @@ If you’d like to use the repository from source, you can either install from g
 To install via git:
 
 ```sh
-$ pip install git+ssh://git@github.com/letta-ai/letta-python#1.0-release.git
+$ pip install git+ssh://git@github.com/letta-ai/letta-python.git
 ```
 
 Alternatively, you can build from source and install the wheel file:

letta_client-1.6.0/PKG-INFO

@@ -0,0 +1,436 @@
+Metadata-Version: 2.3
+Name: letta-client
+Version: 1.6.0
+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
+Author: Letta
+License: Apache-2.0
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: anyio<5,>=3.5.0
+Requires-Dist: distro<2,>=1.7.0
+Requires-Dist: httpx<1,>=0.23.0
+Requires-Dist: pydantic<3,>=1.9.0
+Requires-Dist: sniffio
+Requires-Dist: typing-extensions<5,>=4.10
+Provides-Extra: aiohttp
+Requires-Dist: aiohttp; extra == 'aiohttp'
+Requires-Dist: httpx-aiohttp>=0.1.9; extra == 'aiohttp'
+Description-Content-Type: text/markdown
+
+# Letta Python SDK
+
+[![pypi](https://img.shields.io/pypi/v/letta-client)](https://pypi.python.org/pypi/letta-client)
+
+Letta is the platform for building stateful agents: open AI with advanced memory that can learn and self-improve over time.
+
+### Quicklinks:
+* [**Developer Documentation**](https://docs.letta.com): Learn how to create agents using Python or TypeScript
+* [**Python API Reference**](https://github.com/letta-ai/letta-python/tree/main/./reference.md): Complete Python SDK documentation
+* [**Agent Development Environment (ADE)**](https://docs.letta.com/guides/ade/overview): A no-code UI for building stateful agents
+* [**Letta Cloud**](https://app.letta.com/): The fastest way to try Letta
+
+## Get started
+
+Install the Letta Python SDK:
+
+```bash
+pip install letta-client
+```
+
+## Simple Hello World example
+
+In the example below, we'll create a stateful agent with two memory blocks. We'll initialize the `human` memory block with incorrect information, and correct the agent in our first message - which will trigger the agent to update its own memory with a tool call.
+
+*To run the examples, you'll need to get a `LETTA_API_KEY` from [Letta Cloud](https://app.letta.com/api-keys), or run your own self-hosted server (see [our guide](https://docs.letta.com/guides/selfhosting))*
+
+```python
+from letta_client import Letta
+
+client = Letta(api_key="LETTA_API_KEY")
+# client = Letta(base_url="http://localhost:8283")  # if self-hosting
+
+agent_state = client.agents.create(
+    model="openai/gpt-4o-mini",
+    embedding="openai/text-embedding-3-small",
+    memory_blocks=[
+        {
+            "label": "human",
+            "value": "The human's name is Chad. They like vibe coding."
+        },
+        {
+            "label": "persona",
+            "value": "My name is Sam, a helpful assistant."
+        }
+    ],
+    tools=["web_search", "run_code"]
+)
+
+print(agent_state.id)
+# agent-d9be...0846
+
+response = client.agents.messages.create(
+    agent_id=agent_state.id,
+    messages=[
+        {
+            "role": "user",
+            "content": "Hey, nice to meet you, my name is Brad."
+        }
+    ]
+)
+
+# the agent will think, then edit its memory using a tool
+for message in response.messages:
+    print(message)
+
+# The content of this memory block will be something like
+# "The human's name is Brad. They like vibe coding."
+# Fetch this block's content with:
+human_block = client.agents.blocks.retrieve(agent_id=agent_state.id, block_label="human")
+print(human_block.value)
+```
+
+## Core concepts in Letta:
+
+Letta is built on the [MemGPT](https://arxiv.org/abs/2310.08560) research paper, which introduced the concept of the "LLM Operating System" for memory management:
+
+1. [**Memory Hierarchy**](https://docs.letta.com/guides/agents/memory): Agents have self-editing memory split between in-context and out-of-context memory
+2. [**Memory Blocks**](https://docs.letta.com/guides/agents/memory-blocks): In-context memory is composed of persistent editable blocks
+3. [**Agentic Context Engineering**](https://docs.letta.com/guides/agents/context-engineering): Agents control their context window using tools to edit, delete, or search memory
+4. [**Perpetual Self-Improving Agents**](https://docs.letta.com/guides/agents/overview): Every agent has a perpetual (infinite) message history
+
+## Local Development
+
+Connect to a local Letta server instead of the cloud:
+
+```python
+from letta_client import Letta
+
+client = Letta(base_url="http://localhost:8283")
+```
+
+Run Letta locally with Docker:
+
+```bash
+docker run \
+  -v ~/.letta/.persist/pgdata:/var/lib/postgresql/data \
+  -p 8283:8283 \
+  -e OPENAI_API_KEY="your_key" \
+  letta/letta:latest
+```
+
+See the [self-hosting guide](https://docs.letta.com/guides/selfhosting) for more options.
+
+## Key Features
+
+### Memory Management ([full guide](https://docs.letta.com/guides/agents/memory-blocks))
+
+Memory blocks are persistent, editable sections of an agent's context window:
+
+```python
+# Create agent with memory blocks
+agent = client.agents.create(
+    memory_blocks=[
+        {"label": "persona", "value": "I'm a helpful assistant."},
+        {"label": "human", "value": "User preferences and info."}
+    ]
+)
+
+# Update blocks manually
+client.agents.blocks.update(
+    agent_id=agent.id,
+    block_label="human",
+    value="Updated user information"
+)
+
+# Retrieve a block
+block = client.agents.blocks.retrieve(agent_id=agent.id, block_label="human")
+```
+
+### Multi-agent Shared Memory ([full guide](https://docs.letta.com/guides/agents/multi-agent-shared-memory))
+
+Memory blocks can be attached to multiple agents. All agents will have an up-to-date view on the contents of the memory block -- if one agent modifies it, the other will see it immediately.
+
+Here is how to attach a single memory block to multiple agents:
+
+```python
+# Create shared block
+shared_block = client.blocks.create(
+    label="organization",
+    value="Shared team context"
+)
+
+# Attach to multiple agents
+agent1 = client.agents.create(
+    memory_blocks=[{"label": "persona", "value": "I am a supervisor"}],
+    block_ids=[shared_block.id]
+)
+
+agent2 = client.agents.create(
+    memory_blocks=[{"label": "persona", "value": "I am a worker"}],
+    block_ids=[shared_block.id]
+)
+```
+
+### Sleep-time Agents ([full guide](https://docs.letta.com/guides/agents/architectures/sleeptime))
+
+Background agents that share memory with your primary agent:
+
+```python
+agent = client.agents.create(
+    model="openai/gpt-4o-mini",
+    enable_sleeptime=True  # creates a sleep-time agent
+)
+```
+
+### Agent File Import/Export ([full guide](https://docs.letta.com/guides/agents/agent-file))
+
+Save and share agents with the `.af` file format:
+
+```python
+# Import agent
+with open('/path/to/agent.af', 'rb') as f:
+    agent = client.agents.import_file(file=f)
+
+# Export agent
+schema = client.agents.export_file(agent_id=agent.id)
+```
+
+### MCP Tools ([full guide](https://docs.letta.com/guides/mcp/overview))
+
+Connect to Model Context Protocol servers:
+
+```python
+# First, create an MCP server (example: weather server)
+weather_server = client.mcp_servers.create(
+    server_name="weather-server",
+    config={
+        "mcp_server_type": "streamable_http",
+        "server_url": "https://weather-mcp.example.com/mcp",
+    }
+)
+
+# List tools available from the MCP server
+tools = client.mcp_servers.tools.list(weather_server.id)
+
+# Create agent with MCP tool
+agent = client.agents.create(
+    model="openai/gpt-4o-mini",
+    tool_ids=[tool.id]
+)
+```
+
+### Filesystem ([full guide](https://docs.letta.com/guides/agents/filesystem))
+
+Give agents access to files:
+
+```python
+# Create folder and upload file
+folder = client.folders.create(
+    name="my_folder",
+)
+
+with open("file.txt", "rb") as f:
+    client.folders.files.upload(file=f, folder_id=folder.id)
+
+# Attach to agent
+client.agents.folders.attach(agent_id=agent.id, folder_id=folder.id)
+```
+
+### Long-running Agents ([full guide](https://docs.letta.com/guides/agents/long-running))
+
+Background execution with resumable streaming:
+
+```python
+stream = client.agents.messages.create(
+    agent_id=agent.id,
+    messages=[{"role": "user", "content": "Analyze this dataset"}],
+    background=True
+)
+
+run_id = None
+last_seq_id = None
+for chunk in stream:
+    run_id = chunk.run_id
+    last_seq_id = chunk.seq_id
+
+# Resume if disconnected
+for chunk in client.runs.stream(run_id=run_id, starting_after=last_seq_id):
+    print(chunk)
+```
+
+### Streaming ([full guide](https://docs.letta.com/guides/agents/streaming))
+
+Stream responses in real-time:
+
+```python
+stream = client.agents.messages.stream(
+    agent_id=agent.id,
+    messages=[{"role": "user", "content": "Hello!"}]
+)
+
+for chunk in stream:
+    print(chunk)
+```
+
+These methods return an [`APIResponse`](https://github.com/letta-ai/letta-python/tree/main/src/letta_client/_response.py) object.
+
+The async client returns an [`AsyncAPIResponse`](https://github.com/letta-ai/letta-python/tree/main/src/letta_client/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+
+### Message Types ([full guide](https://docs.letta.com/guides/agents/message-types))
+
+Agent responses contain different message types. Handle them with the `message_type` discriminator:
+
+```python
+messages = client.agents.messages.list(agent_id=agent.id) 
+
+for message in messages:
+    if message.message_type == "user_message":
+        print(f"User: {message.content}")
+    elif message.message_type == "assistant_message":
+        print(f"Agent: {message.content}")
+    elif message.message_type == "reasoning_message":
+        print(f"Reasoning: {message.reasoning}")
+    elif message.message_type == "tool_call_message":
+        print(f"Tool: {message.tool_call.name}")
+    elif message.message_type == "tool_return_message":
+        print(f"Result: {message.tool_return}")
+```
+
+## Python Support
+
+Full type hints and async support:
+
+```python
+from letta_client import Letta
+from letta_client.types import CreateAgentRequest
+
+# Sync client
+client = Letta(token="LETTA_API_KEY")
+
+# Async client
+from letta_client import AsyncLetta
+
+async_client = AsyncLetta(token="LETTA_API_KEY")
+agent = await async_client.agents.create(
+    model="openai/gpt-4o-mini",
+    memory_blocks=[...]
+)
+```
+
+## Error Handling
+
+```python
+from letta_client.core.api_error import ApiError
+
+try:
+    client.agents.messages.create(agent_id=agent_id, messages=[...])
+except ApiError as e:
+    print(e.status_code)
+    print(e.message)
+    print(e.body)
+```
+
+## Advanced Configuration
+
+### Retries
+
+```python
+response = client.agents.create(
+    {...},
+    request_options={"max_retries": 3}  # Default: 2
+)
+```
+
+### Timeouts
+
+```python
+response = client.agents.create(
+    {...},
+    request_options={"timeout_in_seconds": 30}  # Default: 60
+)
+```
+
+### Custom Headers
+
+```python
+response = client.agents.create(
+    {...},
+    request_options={
+        "additional_headers": {
+            "X-Custom-Header": "value"
+        }
+    }
+)
+```
+
+### Raw Response Access
+
+```python
+response = client.agents.with_raw_response.create({...})
+
+print(response.headers["X-My-Header"])
+print(response.data)  # access the underlying object
+```
+
+### Custom HTTP Client
+
+```python
+import httpx
+from letta_client import Letta
+
+client = Letta(
+    httpx_client=httpx.Client(
+        proxies="http://my.test.proxy.example.com",
+        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
+    )
+)
+```
+
+## Runtime Compatibility
+
+Works with:
+- Python 3.8+
+- Supports async/await
+- Compatible with type checkers (mypy, pyright)
+
+## Contributing
+
+Letta is an open source project built by over a hundred contributors. There are many ways to get involved in the Letta OSS project!
+
+* [**Join the Discord**](https://discord.gg/letta): Chat with the Letta devs and other AI developers.
+* [**Chat on our forum**](https://forum.letta.com/): If you're not into Discord, check out our developer forum.
+* **Follow our socials**: [Twitter/X](https://twitter.com/Letta_AI), [LinkedIn](https://www.linkedin.com/company/letta-ai/), [YouTube](https://www.youtube.com/@letta-ai)
+
+This SDK is generated programmatically. For SDK changes, please [open an issue](https://github.com/letta-ai/letta-python/issues).
+
+README contributions are always welcome!
+
+## Resources
+
+- [Documentation](https://docs.letta.com)
+- [Python API Reference](https://github.com/letta-ai/letta-python/tree/main/./reference.md)
+- [Example Applications](https://github.com/letta-ai/letta-chatbot-example)
+
+## License
+
+MIT
+
+---
+
+***Legal notices**: By using Letta and related Letta services (such as the Letta endpoint or hosted service), you are agreeing to our [privacy policy](https://www.letta.com/privacy-policy) and [terms of service](https://www.letta.com/terms-of-service).*