riffdb-langgraph 0.2.0__tar.gz

riffdb_langgraph-0.2.0/.github/riffdb-revision

@@ -0,0 +1 @@
+fc72da6e3d2af6ab29be72712139e9d16bcaf233

riffdb_langgraph-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,175 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: 'Release tag to verify (for example v0.2.0)'
+        required: false
+        default: 'v0.2.0'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  verify-and-build:
+    name: Verify adapter and build Python distributions
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    outputs:
+      release_tag: ${{ steps.meta.outputs.release_tag }}
+      version: ${{ steps.meta.outputs.version }}
+      revision: ${{ steps.meta.outputs.revision }}
+    steps:
+      - name: Check out adapter
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - name: Install Python
+        uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
+        with:
+          python-version: '3.13'
+      - name: Install uv
+        run: python3 -m pip install --quiet uv
+      - name: Resolve release metadata and download RiffDB release bundle
+        id: meta
+        run: |
+          if [[ "${{ github.event_name }}" == "push" ]]; then
+            release_tag="${GITHUB_REF_NAME}"
+          else
+            release_tag="${{ inputs.release_tag || 'v0.2.0' }}"
+          fi
+          [[ "$release_tag" =~ ^v([0-9]+\.[0-9]+\.[0-9]+)$ ]]
+          version="${BASH_REMATCH[1]}"
+          python3 - "$version" <<'PY'
+          from pathlib import Path
+          import sys
+          import tomllib
+          expected = sys.argv[1]
+          pyproject = tomllib.loads(Path("pyproject.toml").read_text(encoding="utf-8"))
+          assert pyproject["project"]["version"] == expected, pyproject["project"]["version"]
+          init_text = Path("src/riffdb_langgraph/__init__.py").read_text(encoding="utf-8")
+          assert f'__version__ = "{expected}"' in init_text, init_text
+          PY
+          riffdb_rev="$(cat .github/riffdb-revision)"
+          [[ "$riffdb_rev" =~ ^[0-9a-f]{40}$ ]]
+
+          bundle="riffdb-${version}-x86_64-unknown-linux-gnu.tar.gz"
+          base_url="https://github.com/riffdb/riffdb/releases/download/${release_tag}"
+          mkdir -p "$RUNNER_TEMP/riffdb-release"
+          curl -fsSL "$base_url/release-provenance-v1.json" -o "$RUNNER_TEMP/riffdb-release/release-provenance-v1.json"
+          curl -fsSL "$base_url/$bundle" -o "$RUNNER_TEMP/riffdb-release/$bundle"
+          expected_sha="$(jq -r '.bundle_archive.sha256' "$RUNNER_TEMP/riffdb-release/release-provenance-v1.json")"
+          echo "${expected_sha}  $RUNNER_TEMP/riffdb-release/$bundle" | sha256sum -c -
+          tar -xzf "$RUNNER_TEMP/riffdb-release/$bundle" -C "$RUNNER_TEMP/riffdb-release"
+          bundle_dir="$RUNNER_TEMP/riffdb-release/riffdb-${version}-x86_64-unknown-linux-gnu"
+          [[ "$(tr -d '\n' < "$bundle_dir/REVISION")" == "$riffdb_rev" ]]
+          "$bundle_dir/bin/riffdb" application check
+
+          printf 'release_tag=%s\n' "$release_tag" >>"$GITHUB_OUTPUT"
+          printf 'version=%s\n' "$version" >>"$GITHUB_OUTPUT"
+          printf 'revision=%s\n' "$riffdb_rev" >>"$GITHUB_OUTPUT"
+      - name: Run adapter checks and build wheel and sdist
+        run: |
+          uv sync --locked
+          make check
+          mkdir -p "$RUNNER_TEMP/release-out"
+          uv build --out-dir "$RUNNER_TEMP/release-out"
+          (
+            cd "$RUNNER_TEMP/release-out"
+            sha256sum "riffdb_langgraph-${{ steps.meta.outputs.version }}"* >SHA256SUMS
+          )
+      - name: Upload verified release artifacts
+        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
+        with:
+          name: riffdb-langgraph-release
+          path: ${{ runner.temp }}/release-out/*
+          if-no-files-found: error
+
+  publish-release:
+    name: Publish GitHub Release and PyPI package
+    needs: [verify-and-build]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: write
+      id-token: write
+      attestations: write
+    steps:
+      - name: Check out adapter
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - name: Download verified release artifacts
+        uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333 # v8.0.2
+        with:
+          name: riffdb-langgraph-release
+          path: release-out
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@4d101475d8b20a2381f78447822ac1eab6504dd8 # v4.2.2
+        with:
+          subject-path: |
+            release-out/riffdb_langgraph-${{ needs.verify-and-build.outputs.version }}-py3-none-any.whl
+            release-out/riffdb_langgraph-${{ needs.verify-and-build.outputs.version }}.tar.gz
+            release-out/SHA256SUMS
+      - name: Publish GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          tag="${{ needs.verify-and-build.outputs.release_tag }}"
+          version="${{ needs.verify-and-build.outputs.version }}"
+          notes="Compiled RiffDB checkpoint-saver adapter for LangGraph v${version} (pinned to RiffDB \`${{ needs.verify-and-build.outputs.revision }}\` and \`riffdb==${version}\`)."
+          if gh release view "$tag" >/dev/null 2>&1; then
+            gh release upload "$tag" release-out/* --clobber
+          else
+            gh release create "$tag" release-out/* \
+              --title "riffdb-langgraph ${tag}" \
+              --notes "$notes" \
+              --verify-tag
+          fi
+      - name: Publish to PyPI (when token or Trusted Publishing is configured)
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          python3 -m pip install --quiet twine
+          if [[ -n "${PYPI_TOKEN:-}" ]]; then
+            python3 -m twine upload --non-interactive --skip-existing -u __token__ -p "$PYPI_TOKEN" release-out/*.whl release-out/*.tar.gz
+          else
+            python3 - <<'PY' || echo "::warning::PyPI Trusted Publishing or PYPI_TOKEN is not yet configured for riffdb-langgraph; GitHub Release wheel and sdist are published."
+          import json
+          import os
+          import subprocess
+          import sys
+          import urllib.request
+
+          req_url = os.environ["ACTIONS_ID_TOKEN_REQUEST_URL"]
+          req_tok = os.environ["ACTIONS_ID_TOKEN_REQUEST_TOKEN"]
+          sep = "&" if "?" in req_url else "?"
+          req = urllib.request.Request(
+              f"{req_url}{sep}audience=pypi",
+              headers={"Authorization": f"Bearer {req_tok}", "Accept": "application/json; api-version=2.0"},
+          )
+          with urllib.request.urlopen(req, timeout=30) as resp:
+              jwt = json.loads(resp.read().decode("utf-8"))["value"]
+          mint = urllib.request.Request(
+              "https://upload.pypi.org/_/oidc/mint-token",
+              data=json.dumps({"token": jwt}).encode("utf-8"),
+              headers={"Content-Type": "application/json", "Accept": "application/json"},
+              method="POST",
+          )
+          with urllib.request.urlopen(mint, timeout=30) as resp:
+              pypi_tok = json.loads(resp.read().decode("utf-8"))["token"]
+          import glob
+          pkgs = sorted(glob.glob("release-out/*.whl") + glob.glob("release-out/*.tar.gz"))
+          subprocess.run(
+              [sys.executable, "-m", "twine", "upload", "--non-interactive", "--skip-existing", "-u", "__token__", "-p", pypi_tok, *pkgs],
+              check=True,
+          )
+          PY
+          fi

riffdb_langgraph-0.2.0/.github/workflows/riffdb-compatibility.yml

@@ -0,0 +1,69 @@
+name: RiffDB compatibility
+
+on:
+  push:
+  pull_request:
+  schedule:
+    - cron: '23 4 * * *'
+  workflow_dispatch:
+    inputs:
+      riffdb_ref:
+        description: 'Full RiffDB commit or main; empty uses the adapter pin'
+        required: false
+        default: ''
+
+permissions:
+  contents: read
+
+concurrency:
+  group: riffdb-compatibility-${{ github.ref }}-${{ github.event_name }}
+  cancel-in-progress: true
+
+jobs:
+  application-compatibility:
+    name: Application compatibility
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
+    env:
+      CARGO_INCREMENTAL: '0'
+      CARGO_TARGET_DIR: ${{ github.workspace }}/riffdb/target
+    steps:
+      - name: Check out adapter
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          path: adapter
+          persist-credentials: false
+      - name: Select RiffDB revision
+        id: riffdb
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          REQUESTED_REF: ${{ inputs.riffdb_ref }}
+        run: |
+          revision="$(cat adapter/.github/riffdb-revision)"
+          [[ "$revision" =~ ^[0-9a-f]{40}$ ]]
+          if [[ "$EVENT_NAME" == schedule ]]; then revision=main; fi
+          if [[ -n "$REQUESTED_REF" ]]; then revision="$REQUESTED_REF"; fi
+          [[ "$revision" =~ ^([0-9a-f]{40}|main)$ ]]
+          printf 'revision=%s\n' "$revision" >>"$GITHUB_OUTPUT"
+      - name: Check out RiffDB
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          repository: riffdb/riffdb
+          ref: ${{ steps.riffdb.outputs.revision }}
+          path: riffdb
+          persist-credentials: false
+      - name: Install Rust toolchain
+        run: rustup toolchain install 1.98.1 --profile minimal
+      - name: Cache Cargo sources
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v6.1.0
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+          key: cargo-compatibility-${{ runner.os }}-${{ hashFiles('riffdb/Cargo.lock') }}
+      - name: Build selected RiffDB CLI
+        working-directory: riffdb
+        run: cargo build --locked --release -p riffdb-cli --bin riffdb
+      - name: Check adapter application
+        working-directory: adapter
+        run: ../riffdb/target/release/riffdb application check

riffdb_langgraph-0.2.0/.gitignore

@@ -0,0 +1,9 @@
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/

riffdb_langgraph-0.2.0/AGENTS.md

@@ -0,0 +1,54 @@
+# AGENTS.md — RiffDB LangGraph adapter
+
+## Mission
+
+Implement a standalone Python checkpoint-saver adapter for LangGraph using a
+compiled RiffDB application. All LangGraph-specific behavior belongs in this
+repository, never in RiffDB.
+
+## Authoritative inputs
+
+- `langgraph` (`>=1.1.0`), `langgraph-checkpoint` (`>=4.0.0`), and
+  `langgraph-checkpoint-conformance` (`>=0.1.0`), especially
+  `langgraph.checkpoint.base.BaseCheckpointSaver` and the upstream conformance
+  suite (`langgraph.checkpoint.conformance.validate`).
+- This repository's `DESIGN.md`.
+- The accepted RiffDB specification and ADRs at the revision recorded in the
+  generated application lock and `.github/riffdb-revision`.
+
+If these inputs conflict, stop and request maintainer review. Do not weaken a
+LangGraph checkpointer semantic or a RiffDB safety guarantee to make a test
+pass.
+
+## Architecture boundaries
+
+1. LangGraph checkpoint mutations use generated, compiled RiffDB commands only.
+2. Reads use generated named RiffQL queries only. Do not add generic CRUD,
+   dynamically assembled RiffQL, or unbounded scans.
+3. Checkpoint metadata, channel version blobs, and pending task writes belong to
+   a single `Checkpoints` aggregate partitioned by `scope` with `conflict_key
+   (scope, thread_id)`.
+4. `put_writes` / `aput_writes` preserve upstream idempotency rules:
+   non-negative write indices (`write_idx >= 0`) are write-once per
+   `(thread_id, checkpoint_ns, checkpoint_id, task_id, write_idx)`, while
+   special negative indices from `WRITES_IDX_MAP` (`ERROR`, `SCHEDULED`,
+   `INTERRUPT`, `RESUME`) overwrite in place.
+5. `get_tuple` and `list` hydrate channel values from `CheckpointBlob` rows
+   referenced by `channel_versions`, order `pending_writes` via upstream
+   `writes_sort_key`, and migrate `v < 4` parent `TASKS` writes into
+   `channel_values[TASKS]`.
+6. Connection URIs (`riffdb://<database>`) carry only the database alias.
+   Credentials and TLS configuration come from protected environment variables,
+   never from the URI.
+
+## Completion checks
+
+Before calling the adapter usable:
+
+```bash
+make check
+make conformance
+```
+
+Unit fakes may supplement upstream tests but never replace real RiffDB loopback
+and `langgraph-checkpoint-conformance` coverage.

riffdb_langgraph-0.2.0/DESIGN.md

@@ -0,0 +1,64 @@
+# Design
+
+## Compatibility target
+
+`riffdb-langgraph` implements `langgraph.checkpoint.base.BaseCheckpointSaver[str]`
+for `langgraph>=1.1.0` and `langgraph-checkpoint>=4.0.0`, validated against all
+eight capabilities of `langgraph-checkpoint-conformance`:
+
+| Capability | Methods | Behavior |
+|---|---|---|
+| `put` | `put`, `aput` | Atomic checkpoint envelope + channel blob persistence, metadata normalization via `get_checkpoint_metadata` |
+| `put_writes` | `put_writes`, `aput_writes` | Pending task writes with idempotent regular indices (`write_idx >= 0`) and overwritable special indices (`WRITES_IDX_MAP`) |
+| `get_tuple` | `get_tuple`, `aget_tuple` | Latest or specific `checkpoint_id` lookup, channel blob hydration, `pending_writes` ordering via `writes_sort_key`, and `v < 4` `TASKS` migration |
+| `list` | `list`, `alist` | Reverse-chronological (`checkpoint_id DESC`) checkpoint listing with `thread_id`, `checkpoint_ns`, `before`, `limit`, and metadata filtering |
+| `delete_thread` | `delete_thread`, `adelete_thread` | Removal of all checkpoints, channel blobs, and pending writes across all namespaces for a `thread_id` |
+| `delete_for_runs` | `delete_for_runs`, `adelete_for_runs` | Removal of checkpoints (and their pending writes) whose metadata `run_id` matches the target run IDs |
+| `copy_thread` | `copy_thread`, `acopy_thread` | Cloning all checkpoints, channel blobs, and pending writes across all namespaces from a source `thread_id` to a target `thread_id` |
+| `prune` | `prune`, `aprune` | Pruning checkpoints per `(thread_id, checkpoint_ns)` using `keep_latest` or `delete` strategies |
+
+The Python floor is 3.13, matching the RiffDB Python application runtime.
+
+## Contract and aggregate model
+
+The contract (`riffdb/contract.riff`) defines a single aggregate `Checkpoints`
+partitioned by `scope` with `conflict_key (scope, thread_id)`:
+
+- **`Checkpoint`** (root): keyed by `(scope, thread_id, checkpoint_ns, checkpoint_id)`.
+  Stores `parent_checkpoint_id`, typed serde payloads for the stripped checkpoint
+  envelope (`channel_values` removed) and normalized `CheckpointMetadata`, and a
+  monotonic `revision`. Indexed with `binary_utf8_v1` text keys for reverse
+  lexicographic `checkpoint_id` range queries (`< $before_checkpoint_id`).
+- **`CheckpointBlob`** (child): keyed by
+  `(scope, thread_id, checkpoint_ns, checkpoint_id, blob_key)` with
+  `checkpoint_id = ""` and `blob_key = "{len(channel)}:{channel}:{version}"`.
+  Deduplicates serialized channel values across checkpoints within a
+  `(thread_id, checkpoint_ns)`. Empty channel versions are recorded with
+  `serde_type = "empty"` so removed/unwritten channels are omitted on hydration.
+- **`CheckpointWrite`** (child): keyed by
+  `(scope, thread_id, checkpoint_ns, checkpoint_id, task_id, write_idx)`.
+  Stores pending task writes with `initialized: bool` so `PutCheckpointWrites`
+  enforces write-once semantics when `write_idx >= 0` (`allow_overwrite == false`)
+  and overwrites when `write_idx < 0` (`allow_overwrite == true`).
+
+## Configuration
+
+`RiffDBCheckpointSaver` accepts a canonical URI `riffdb://<database>`. It
+contains no credential or TLS material. Connection authority comes from
+protected process configuration:
+
+- `RIFFDB_LANGGRAPH_ENDPOINT` (or fallback `RIFFDB_ENDPOINT`)
+- `RIFFDB_LANGGRAPH_CREDENTIAL_FILE` (or fallback `RIFFDB_CREDENTIAL_FILE`)
+- `RIFFDB_LANGGRAPH_TRUST_ROOT` (optional, for verified TLS)
+- `RIFFDB_LANGGRAPH_SERVER_NAME` (optional, for verified TLS)
+
+The credential file is loaded via `BearerCredential.from_protected_file`.
+Unknown URI schemes, userinfo, ports, paths, query parameters, and fragments
+raise `InvalidCheckpointerURI` before any network activity.
+
+## Session consistency
+
+`RiffDBCheckpointSaver` tracks the highest `commit_sequence` returned by any
+mutation command and attaches `read_after_commit` to subsequent queries on the
+same saver instance, guaranteeing monotonic read-your-writes consistency across
+both sync and async execution paths.

riffdb_langgraph-0.2.0/Makefile

@@ -0,0 +1,26 @@
+UV ?= uv
+PYTHON ?= $(UV) run python
+RIFFDB ?= riffdb
+
+.PHONY: bootstrap format lint typecheck test check conformance
+
+bootstrap:
+	$(UV) sync
+
+format:
+	$(UV) run ruff format --check .
+
+lint:
+	$(UV) run ruff check .
+
+typecheck:
+	$(UV) run mypy
+
+test:
+	$(UV) run pytest
+
+check: format lint typecheck test
+	git diff --exit-code
+
+conformance:
+	$(RIFFDB) dev --reset --exec '$(PYTHON) -m riffdb_langgraph "$$RIFFDB_ENDPOINT" "$$RIFFDB_CREDENTIAL_FILE" "$$RIFFDB_DATABASE"'

riffdb_langgraph-0.2.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.5
+Name: riffdb-langgraph
+Version: 0.2.0
+Summary: Compiled RiffDB checkpoint-saver adapter for LangGraph
+Author: RiffDB contributors
+License: MIT OR Apache-2.0
+Requires-Python: >=3.13
+Requires-Dist: langgraph-checkpoint>=3.0.0
+Requires-Dist: riffdb==0.2.0
+Description-Content-Type: text/markdown
+
+# riffdb-langgraph
+
+`riffdb-langgraph` is a compiled RiffDB checkpoint-saver adapter
+(`RiffDBCheckpointSaver`) for LangGraph (`langgraph>=1.1.0`,
+`langgraph-checkpoint>=4.0.0`). It is an out-of-tree integration: no
+LangGraph-specific code or vocabulary belongs in the RiffDB repository.
+
+The adapter implements both synchronous and asynchronous `BaseCheckpointSaver`
+surfaces and passes all eight capability suites (81 tests) in the upstream
+`langgraph-checkpoint-conformance` package:
+
+- `put` (`put`, `aput`)
+- `put_writes` (`put_writes`, `aput_writes`)
+- `get_tuple` (`get_tuple`, `aget_tuple`)
+- `list` (`list`, `alist`)
+- `delete_thread` (`delete_thread`, `adelete_thread`)
+- `delete_for_runs` (`delete_for_runs`, `adelete_for_runs`)
+- `copy_thread` (`copy_thread`, `acopy_thread`)
+- `prune` (`prune`, `aprune`)
+
+## Usage
+
+```python
+from langgraph.graph import START, END, StateGraph
+from riffdb_langgraph import RiffDBCheckpointSaver
+
+with RiffDBCheckpointSaver("riffdb://langgraph-development") as checkpointer:
+    graph = builder.compile(checkpointer=checkpointer)
+    result = graph.invoke(
+        {"messages": ["hello"]},
+        config={"configurable": {"thread_id": "thread-1"}},
+    )
+```
+
+RiffDB TLS and credential material is supplied through protected environment
+configuration (`RIFFDB_LANGGRAPH_ENDPOINT` and
+`RIFFDB_LANGGRAPH_CREDENTIAL_FILE`) described in [DESIGN.md](DESIGN.md); it is
+never embedded in the checkpointer URI.
+
+## Development and Verification
+
+```bash
+make check
+make conformance
+```
+
+`make conformance` starts a disposable `riffdb dev` instance, runs sync and
+async `StateGraph` fan-out smoke tests, and executes the full
+`langgraph-checkpoint-conformance` validation suite against the live server.
+
+## RiffDB compatibility CI
+
+This adapter owns its RiffDB compatibility checks. Pull requests compile the
+application sources and verify existing locks and generated artifacts against
+the full commit in `.github/riffdb-revision`. Scheduled checks use RiffDB
+`main`; manual dispatch accepts a full commit or `main`. Failures are reported
+here and do not block RiffDB itself.
+
+To upgrade, update the pin, migrate sources as needed, review the result of
+`riffdb application lock --write`, and verify with `riffdb application check`.
+Commit the pin and migration together in this repository.

riffdb_langgraph-0.2.0/README.md

@@ -0,0 +1,61 @@
+# riffdb-langgraph
+
+`riffdb-langgraph` is a compiled RiffDB checkpoint-saver adapter
+(`RiffDBCheckpointSaver`) for LangGraph (`langgraph>=1.1.0`,
+`langgraph-checkpoint>=4.0.0`). It is an out-of-tree integration: no
+LangGraph-specific code or vocabulary belongs in the RiffDB repository.
+
+The adapter implements both synchronous and asynchronous `BaseCheckpointSaver`
+surfaces and passes all eight capability suites (81 tests) in the upstream
+`langgraph-checkpoint-conformance` package:
+
+- `put` (`put`, `aput`)
+- `put_writes` (`put_writes`, `aput_writes`)
+- `get_tuple` (`get_tuple`, `aget_tuple`)
+- `list` (`list`, `alist`)
+- `delete_thread` (`delete_thread`, `adelete_thread`)
+- `delete_for_runs` (`delete_for_runs`, `adelete_for_runs`)
+- `copy_thread` (`copy_thread`, `acopy_thread`)
+- `prune` (`prune`, `aprune`)
+
+## Usage
+
+```python
+from langgraph.graph import START, END, StateGraph
+from riffdb_langgraph import RiffDBCheckpointSaver
+
+with RiffDBCheckpointSaver("riffdb://langgraph-development") as checkpointer:
+    graph = builder.compile(checkpointer=checkpointer)
+    result = graph.invoke(
+        {"messages": ["hello"]},
+        config={"configurable": {"thread_id": "thread-1"}},
+    )
+```
+
+RiffDB TLS and credential material is supplied through protected environment
+configuration (`RIFFDB_LANGGRAPH_ENDPOINT` and
+`RIFFDB_LANGGRAPH_CREDENTIAL_FILE`) described in [DESIGN.md](DESIGN.md); it is
+never embedded in the checkpointer URI.
+
+## Development and Verification
+
+```bash
+make check
+make conformance
+```
+
+`make conformance` starts a disposable `riffdb dev` instance, runs sync and
+async `StateGraph` fan-out smoke tests, and executes the full
+`langgraph-checkpoint-conformance` validation suite against the live server.
+
+## RiffDB compatibility CI
+
+This adapter owns its RiffDB compatibility checks. Pull requests compile the
+application sources and verify existing locks and generated artifacts against
+the full commit in `.github/riffdb-revision`. Scheduled checks use RiffDB
+`main`; manual dispatch accepts a full commit or `main`. Failures are reported
+here and do not block RiffDB itself.
+
+To upgrade, update the pin, migrate sources as needed, review the result of
+`riffdb application lock --write`, and verify with `riffdb application check`.
+Commit the pin and migration together in this repository.

riffdb_langgraph-0.2.0/generated/riffdb.application.exact.json

@@ -0,0 +1 @@
+{"application":"riffdb-langgraph","contract":{"bundle_hash":"b2da9e908d1987b893189d9d470d553edcf05ec700ac3657860ff858b580bcfe","lineage":"RiffDBLangGraph","source":"riffdb/contract.riff","version":1},"generation":{"python":"src/riffdb_langgraph/generated/client.py"},"query_modules":[{"module_hash":"031908018e6cd7507ca0e0f81b8375673f1707c57742af8e964e2b618d185e75","name":"riffdb_langgraph","queries":[{"name":"GetCheckpointBlobs","source":"riffdb/queries/get_checkpoint_blobs.riffq"},{"name":"GetCheckpointById","source":"riffdb/queries/get_checkpoint_by_id.riffq"},{"name":"GetLatestCheckpoint","source":"riffdb/queries/get_latest_checkpoint.riffq"},{"name":"GetParentPendingSends","source":"riffdb/queries/get_parent_pending_sends.riffq"},{"name":"ListCheckpointsByScope","source":"riffdb/queries/list_checkpoints_by_scope.riffq"},{"name":"ListCheckpointsByScopeBefore","source":"riffdb/queries/list_checkpoints_by_scope_before.riffq"},{"name":"ListCheckpointsByThread","source":"riffdb/queries/list_checkpoints_by_thread.riffq"},{"name":"ListCheckpointsByThreadBefore","source":"riffdb/queries/list_checkpoints_by_thread_before.riffq"},{"name":"ListCheckpointsByThreadNs","source":"riffdb/queries/list_checkpoints_by_thread_ns.riffq"},{"name":"ListCheckpointsByThreadNsBefore","source":"riffdb/queries/list_checkpoints_by_thread_ns_before.riffq"},{"name":"ListThreadBlobKeys","source":"riffdb/queries/list_thread_blob_keys.riffq"},{"name":"ListThreadCheckpointKeys","source":"riffdb/queries/list_thread_checkpoint_keys.riffq"},{"name":"ListThreadWriteKeys","source":"riffdb/queries/list_thread_write_keys.riffq"}],"version":1}],"reactive_modules":[],"roles":[{"agent_subscriptions":[],"commands":["DeleteCheckpointBlobs","DeleteCheckpointWrites","DeleteCheckpoints","PutCheckpoint","PutCheckpointBlobs","PutCheckpointWithBlobs","PutCheckpointWrites"],"environment":"development","event_streams":[],"name":"LangGraphCheckpointer","queries":["GetCheckpointBlobs","GetCheckpointById","GetLatestCheckpoint","GetParentPendingSends","ListCheckpointsByScope","ListCheckpointsByScopeBefore","ListCheckpointsByThread","ListCheckpointsByThreadBefore","ListCheckpointsByThreadNs","ListCheckpointsByThreadNsBefore","ListThreadBlobKeys","ListThreadCheckpointKeys","ListThreadWriteKeys"],"row_policies":[],"tenant_scope":"global","watch_queries":[]}],"schema":"riffdb.application-manifest/v5","seed_inputs":[]}

riffdb_langgraph-0.2.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "riffdb-langgraph"
+version = "0.2.0"
+description = "Compiled RiffDB checkpoint-saver adapter for LangGraph"
+readme = "README.md"
+requires-python = ">=3.13"
+license = { text = "MIT OR Apache-2.0" }
+authors = [{ name = "RiffDB contributors" }]
+dependencies = [
+  "langgraph-checkpoint>=3.0.0",
+  "riffdb==0.2.0",
+]
+
+[dependency-groups]
+dev = [
+  "langgraph>=1.0.0",
+  "langgraph-checkpoint-conformance",
+  "mypy>=1.17,<2",
+  "pytest>=8.4,<9",
+  "pytest-asyncio>=1.0",
+  "ruff>=0.12,<0.13",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/riffdb_langgraph"]
+
+[tool.pytest.ini_options]
+addopts = "-ra"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+extend-exclude = ["src/riffdb_langgraph/generated/client.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "RUF"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+packages = ["riffdb_langgraph"]
+exclude = ["src/riffdb_langgraph/generated/client.py"]
+
+[[tool.mypy.overrides]]
+module = [
+  "langgraph.*",
+  "langgraph_checkpoint_conformance.*",
+]
+ignore_missing_imports = true