langgraph_checkpoint_firestore 0.2.0__tar.gz → 0.2.2__tar.gz

{langgraph_checkpoint_firestore-0.2.0 → langgraph_checkpoint_firestore-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langgraph_checkpoint_firestore
-Version: 0.2.0
+Version: 0.2.2
 Summary: LangGraph checkpoint saver for Google Firestore with built-in message history pruning via agentstate-reducer
 Author-email: Kamal <skamalj@github.com>
 Keywords: agent-state,checkpoint,firestore,google-cloud,langchain,langgraph,memory,message-reducer
@@ -19,7 +19,7 @@ Requires-Dist: mypy; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest>=7.0; extra == 'dev'
 Provides-Extra: reducer
-Requires-Dist: agentstate-reducer>=0.1.1; extra == 'reducer'
+Requires-Dist: agentstate-reducer>=0.3.0; extra == 'reducer'
 Description-Content-Type: text/markdown
 
 # langgraph-checkpoint-firestore

{langgraph_checkpoint_firestore-0.2.0 → langgraph_checkpoint_firestore-0.2.2}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "langgraph_checkpoint_firestore"
-version = "0.2.0"
+version = "0.2.2"
 description = "LangGraph checkpoint saver for Google Firestore with built-in message history pruning via agentstate-reducer"
 authors = [{name = "Kamal", email = "skamalj@github.com"}]
-readme = "README.md"
+readme = "readme.md"
 requires-python = ">=3.10"
 dependencies = [
     "langchain-core",
@@ -27,7 +27,7 @@ classifiers = [
 
 [project.optional-dependencies]
 reducer = [
-    "agentstate-reducer>=0.1.1",
+    "agentstate-reducer>=0.3.0",
 ]
 dev = [
     "pytest>=7.0",

{langgraph_checkpoint_firestore-0.2.0 → langgraph_checkpoint_firestore-0.2.2}/uv.lock

@@ -11,11 +11,11 @@ resolution-markers = [
 
 [[package]]
 name = "agentstate-reducer"
-version = "0.1.1"
+version = "0.3.0"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/13/2e/783d9c08b2b9586921d4478ad3cf8e5dc30c2300b0ccab524a23f4cbd819/agentstate_reducer-0.1.1.tar.gz", hash = "sha256:9b19729a0626b3220de1e5189dbb6e88b8f78a059347acdde17bcc3d7c9e7229", size = 10862, upload-time = "2026-06-26T12:05:01.121Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/66/2f/8ae3e2a6e39e8b11879fd0a8c139107bd114388d2ad8d6cf723e29b05ded/agentstate_reducer-0.3.0.tar.gz", hash = "sha256:9f760f595b206ed69c8104d8b771613c2937ee90bd4b842fe2bc32a72e90e000", size = 34742, upload-time = "2026-07-26T07:10:49.387Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/b8/76/e5aa1b033799f8be438e1913965a0006c638c01947923fb8561f1850efe6/agentstate_reducer-0.1.1-py3-none-any.whl", hash = "sha256:fd9a05e29fcf69a1291d1efe1826b702f8e02742121d179867327b1eabc15b5e", size = 8761, upload-time = "2026-06-26T12:05:02.127Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/3a/f02127dce0708754bcdc1446cf3f4c875d129b2b8677c8eebf03b12415a0/agentstate_reducer-0.3.0-py3-none-any.whl", hash = "sha256:79d2174fe9e737f4cede6285b3a786c4fc2e7140481c9222ce7a97f220764684", size = 14703, upload-time = "2026-07-26T07:10:47.928Z" },
 ]
 
 [[package]]
@@ -516,7 +516,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions", marker = "python_full_version < '3.11'" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [
@@ -937,7 +937,7 @@ wheels = [
 
 [[package]]
 name = "langgraph-checkpoint-firestore"
-version = "0.2.0"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "google-cloud-firestore" },
@@ -967,7 +967,7 @@ dev = [
 
 [package.metadata]
 requires-dist = [
-    { name = "agentstate-reducer", marker = "extra == 'reducer'", specifier = ">=0.1.1" },
+    { name = "agentstate-reducer", marker = "extra == 'reducer'", specifier = ">=0.3.0" },
     { name = "black", marker = "extra == 'dev'" },
     { name = "google-cloud-firestore" },
     { name = "isort", marker = "extra == 'dev'" },

langgraph_checkpoint_firestore-0.2.0/README.md

@@ -1,167 +0,0 @@
-# langgraph-checkpoint-firestore
-
-Google Firestore checkpoint saver for [LangGraph](https://github.com/langchain-ai/langgraph). Persists agent state between runs so your graphs can resume from any prior checkpoint.
-
-**What makes this checkpointer different:** it has message history pruning built in. Pass a `MessageReducer` and the checkpointer automatically caps your message list before writing to Firestore — no extra code in your graph, no state annotation changes required. This is the only LangGraph Firestore checkpointer with this capability.
-
-## Features
-
-- **Full checkpoint persistence** — save, retrieve, and list LangGraph checkpoints in Google Firestore
-- **Built-in message pruning** — optional `MessageReducer` prunes message history at the persistence layer, keeping checkpoints lean without changing your graph code
-- **Sync and async API** — `put`/`get_tuple`/`list` and their `aput`/`aget_tuple`/`alist` async counterparts
-- **Subgraph support** — correctly checkpoints parent and subgraph state independently
-- **Native Firestore hierarchy** — checkpoints stored in subcollections per thread, enabling efficient per-thread queries
-
-## Installation
-
-```bash
-pip install langgraph-checkpoint-firestore
-```
-
-With optional message pruning support:
-
-```bash
-pip install "langgraph-checkpoint-firestore[reducer]"
-```
-
-**Requires Python 3.10+**
-
-## Firestore Setup
-
-The saver uses Google Cloud Application Default Credentials. Set up auth with one of:
-
-```bash
-# Local development — authenticate with your Google account
-gcloud auth application-default login
-
-# Service account (CI / production)
-export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"
-```
-
-Your Firestore instance must be in **Native mode** (not Datastore mode). Collections are created automatically on first write — no manual setup required.
-
-## Quick Start
-
-```python
-from langgraph.graph import StateGraph, MessagesState, START
-from langchain_openai import ChatOpenAI
-from langgraph_checkpoint_firestore import FirestoreSaver
-
-model = ChatOpenAI(model="gpt-4o-mini")
-
-def call_model(state: MessagesState):
-    return {"messages": model.invoke(state["messages"])}
-
-builder = StateGraph(MessagesState)
-builder.add_node("call_model", call_model)
-builder.add_edge(START, "call_model")
-
-with FirestoreSaver.from_conn_info(project_id="my-gcp-project", checkpoints_collection="checkpoints") as checkpointer:
-    graph = builder.compile(checkpointer=checkpointer)
-
-    config = {"configurable": {"thread_id": "user-123"}}
-
-    # First run — state is saved to Firestore
-    graph.invoke({"messages": [{"role": "user", "content": "Hi, I'm Kamal"}]}, config)
-
-    # Second run — picks up where it left off
-    graph.invoke({"messages": [{"role": "user", "content": "What's my name?"}]}, config)
-```
-
-## API Reference
-
-### `FirestoreSaver(project_id, checkpoints_collection, reducer=None, messages_key="messages")`
-
-| Parameter | Type | Default | Description |
-|---|---|---|---|
-| `project_id` | `str` | required | Google Cloud project ID |
-| `checkpoints_collection` | `str` | `"checkpoints"` | Root Firestore collection name |
-| `reducer` | `MessageReducer` | `None` | Optional pruner — see [Message Pruning](#built-in-message-pruning) |
-| `messages_key` | `str` | `"messages"` | State channel name that holds the message list |
-
-You can also use the context manager factory:
-
-```python
-with FirestoreSaver.from_conn_info(
-    project_id="my-gcp-project",
-    checkpoints_collection="checkpoints",
-    reducer=reducer,
-    messages_key="messages"
-) as saver:
-    graph = builder.compile(checkpointer=saver)
-```
-
-### Sync methods
-
-| Method | Description |
-|---|---|
-| `put(config, checkpoint, metadata, new_versions)` | Save a checkpoint |
-| `put_writes(config, writes, task_id)` | Save pending writes for a checkpoint |
-| `get_tuple(config)` | Retrieve the latest (or a specific) checkpoint |
-| `list(config, *, before, limit)` | Iterate checkpoints for a thread |
-
-### Async methods
-
-All sync methods have async counterparts: `aput`, `aput_writes`, `aget_tuple`, `alist`.
-
-## Built-in Message Pruning
-
-Long-running agents accumulate message history with every turn. Left unchecked this inflates checkpoint size, increases Firestore storage costs, and eventually blows past LLM context limits.
-
-This checkpointer solves that at the persistence layer: pass a `MessageReducer` and it automatically prunes the message list inside `put()` before the checkpoint is serialised and written to Firestore. **Your graph code, state definition, and node logic stay untouched.**
-
-This is an alternative to — or complement of — the LangGraph `Annotated[list, reducer_fn]` pattern. Use the checkpoint-layer approach when:
-
-- You don't own the graph or state definition (e.g. using a pre-built LangGraph agent)
-- You want pruning to happen unconditionally at every save, regardless of which node triggered it
-- You want to keep all in-memory state intact and only prune what gets persisted
-
-### Install with reducer support
-
-```bash
-pip install "langgraph-checkpoint-firestore[reducer]"
-```
-
-### Usage
-
-```python
-from agentstate_reducer import MessageReducer
-from langgraph_checkpoint_firestore import FirestoreSaver
-
-reducer = MessageReducer(min_messages=10, max_messages=20)
-
-with FirestoreSaver.from_conn_info(
-    project_id="my-gcp-project",
-    checkpoints_collection="checkpoints",
-    reducer=reducer,        # prune before each checkpoint save
-    messages_key="messages" # state channel holding the message list (default)
-) as checkpointer:
-    graph = builder.compile(checkpointer=checkpointer)
-```
-
-When `len(messages) > max_messages`, the oldest `human`/`ai` messages are removed until `min_messages` remain. The following are **never** pruned:
-
-- Index 0 (typically the system prompt) — controlled by `preserve_first=True`
-- `system` and `function` messages
-- `tool` messages — unless their parent `ai` message is pruned (cascade behaviour, configurable)
-
-See [agentstate-reducer on PyPI](https://pypi.org/project/agentstate-reducer/) for full configuration: `preserve_first`, `cascade_tool_messages`, `summarize_fn`, and role alias support (`user`/`assistant`/`agent`).
-
-## Data Model
-
-Checkpoints are stored in a hierarchical Firestore structure:
-
-```
-{checkpoints_collection}/
-  {thread_id}_{checkpoint_ns}/          ← partition document
-    checkpoints/
-      {checkpoint_id}                   ← checkpoint document
-        writes/
-          {task_id}_{idx}               ← pending write documents
-```
-
-This structure enables efficient per-thread checkpoint queries and keeps checkpoint data co-located with its pending writes.
-
-## License
-
-MIT