langgraph-runtime-pg 0.11.1__tar.gz

langgraph_runtime_pg-0.11.1/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.egg-info/
+dist/
+build/
+.langgraph_api/
+.cache/
+.tests/
+.DS_Store
+.env
+*.pckl

langgraph_runtime_pg-0.11.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohankumar Ramachandran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langgraph_runtime_pg-0.11.1/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: langgraph-runtime-pg
+Version: 0.11.1
+Summary: Self-hosted LangSmith Deployments alternative: MIT Postgres+Redis runtime (edition=pg) for stock langgraph-api
+Project-URL: Homepage, https://github.com/langhost/langhost
+Project-URL: Repository, https://github.com/langhost/langhost
+Project-URL: Issues, https://github.com/langhost/langhost/issues
+Project-URL: Changelog, https://github.com/langhost/langhost/releases
+Author-email: Mohankumar Ramachandran <mail@mohanram.dev>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agent-protocol,agent-server,agents,ai-agents,asgi,checkpoint,langchain,langgraph,langgraph-api,langgraph-checkpoint,langgraph-sdk,langsmith,langsmith-deployments,llm,multi-agent,open-source,postgres,postgresql,redis,runtime,self-hosted,uvicorn
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: alembic>=1.14
+Requires-Dist: asyncpg>=0.29
+Requires-Dist: croniter>=1.0
+Requires-Dist: langgraph-api==0.11.1
+Requires-Dist: langgraph-checkpoint-postgres==3.1.0
+Requires-Dist: orjson>=3.9
+Requires-Dist: psycopg[binary]>=3.3.4
+Requires-Dist: redis>=5.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.51
+Requires-Dist: starlette>=0.37
+Requires-Dist: structlog>=24.0
+Description-Content-Type: text/markdown
+
+# langgraph-runtime-pg
+
+MIT Postgres + Redis runtime (`LANGGRAPH_RUNTIME_EDITION=pg`) for stock
+[`langgraph-api`](https://pypi.org/project/langgraph-api/).
+
+See the [repository README](https://github.com/langhost/langhost)
+for setup, CLI (`langhost`), and architecture.

langgraph_runtime_pg-0.11.1/README.md

@@ -0,0 +1,7 @@
+# langgraph-runtime-pg
+
+MIT Postgres + Redis runtime (`LANGGRAPH_RUNTIME_EDITION=pg`) for stock
+[`langgraph-api`](https://pypi.org/project/langgraph-api/).
+
+See the [repository README](https://github.com/langhost/langhost)
+for setup, CLI (`langhost`), and architecture.

langgraph_runtime_pg-0.11.1/pyproject.toml

@@ -0,0 +1,84 @@
+[project]
+name = "langgraph-runtime-pg"
+# Tracks langgraph-api: X.Y.Z or X.Y.Z.postN for our patches on the same API.
+version = "0.11.1"
+description = "Self-hosted LangSmith Deployments alternative: MIT Postgres+Redis runtime (edition=pg) for stock langgraph-api"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "Mohankumar Ramachandran", email = "mail@mohanram.dev" }]
+keywords = [
+    "langgraph",
+    "langsmith",
+    "langsmith-deployments",
+    "langchain",
+    "langgraph-api",
+    "langgraph-sdk",
+    "langgraph-checkpoint",
+    "agent-server",
+    "agent-protocol",
+    "ai-agents",
+    "agents",
+    "multi-agent",
+    "llm",
+    "self-hosted",
+    "open-source",
+    "postgres",
+    "postgresql",
+    "redis",
+    "checkpoint",
+    "runtime",
+    "uvicorn",
+    "asgi",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Database",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "sqlalchemy[asyncio]>=2.0.51",
+    "asyncpg>=0.29",
+    "redis>=5.0",
+    "alembic>=1.14",
+    "psycopg[binary]>=3.3.4",
+    "structlog>=24.0",
+    "croniter>=1.0",
+    "orjson>=3.9",
+    "starlette>=0.37",
+    # Exact Agent Server this runtime edition targets (version sync enforced in CI).
+    "langgraph-api==0.11.1",
+    "langgraph-checkpoint-postgres==3.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/langhost/langhost"
+Repository = "https://github.com/langhost/langhost"
+Issues = "https://github.com/langhost/langhost/issues"
+Changelog = "https://github.com/langhost/langhost/releases"
+
+[project.scripts]
+langgraph-runtime-pg-migrate = "langgraph_runtime_pg.migrate:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/langgraph_runtime_pg"]
+
+# Keep Alembic templates / non-.py migration assets in the wheel.
+[tool.hatch.build.targets.wheel.force-include]
+"src/langgraph_runtime_pg/migrations/script.py.mako" = "langgraph_runtime_pg/migrations/script.py.mako"

langgraph_runtime_pg-0.11.1/src/langgraph_runtime_pg/__init__.py

@@ -0,0 +1,38 @@
+"""Postgres+Redis LangGraph runtime (LANGGRAPH_RUNTIME_EDITION=pg)."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from langgraph_runtime_pg import (
+    checkpoint,
+    database,
+    lifespan,
+    metrics,
+    migrate,
+    models,
+    ops,
+    queue,
+    redis_stream,
+    retry,
+    routes,
+    store,
+)
+
+try:
+    __version__ = version("langgraph-runtime-pg")
+except PackageNotFoundError:  # pragma: no cover - editable / source tree edge
+    __version__ = "0.0.0"
+__all__ = [
+    "__version__",
+    "checkpoint",
+    "database",
+    "lifespan",
+    "metrics",
+    "migrate",
+    "models",
+    "ops",
+    "queue",
+    "redis_stream",
+    "retry",
+    "routes",
+    "store",
+]

langgraph_runtime_pg-0.11.1/src/langgraph_runtime_pg/checkpoint.py

@@ -0,0 +1,83 @@
+"""Checkpointer factory wrapping langgraph-checkpoint-postgres."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import Any, cast
+
+from langgraph.checkpoint.postgres.aio import AsyncPostgresSaver
+from psycopg.rows import dict_row
+from psycopg_pool import AsyncConnectionPool
+
+from langgraph_runtime_pg.database import to_psycopg_uri
+
+_POOL: AsyncConnectionPool[Any] | None = None
+_CHECKPOINTER: AsyncPostgresSaver | None = None
+_SETUP_LOCK = asyncio.Lock()
+
+
+async def setup_checkpointer() -> AsyncPostgresSaver:
+    """Open a psycopg pool and initialize AsyncPostgresSaver tables."""
+    global _POOL, _CHECKPOINTER
+    async with _SETUP_LOCK:
+        if _CHECKPOINTER is not None:
+            return _CHECKPOINTER
+        if _POOL is not None:
+            try:
+                await _POOL.close()
+            except Exception:
+                pass
+            _POOL = None
+
+        uri = to_psycopg_uri()
+        # autocommit required: setup() runs CREATE INDEX CONCURRENTLY
+        pool = AsyncConnectionPool(
+            conninfo=uri,
+            min_size=1,
+            max_size=10,
+            open=False,
+            kwargs={
+                "autocommit": True,
+                "prepare_threshold": 0,
+                "row_factory": dict_row,
+            },
+        )
+        try:
+            await pool.open()
+            saver = AsyncPostgresSaver(cast(Any, pool))
+            await saver.setup()
+        except Exception:
+            try:
+                await pool.close()
+            except Exception:
+                pass
+            raise
+        _POOL = pool
+        _CHECKPOINTER = saver
+        return _CHECKPOINTER
+
+
+async def teardown_checkpointer() -> None:
+    """Close the checkpointer pool."""
+    global _POOL, _CHECKPOINTER
+    _CHECKPOINTER = None
+    pool = _POOL
+    _POOL = None
+    if pool is not None:
+        try:
+            await pool.close()
+        except Exception:
+            pass
+
+
+def Checkpointer(*args: Any, unpack_hook: Any = None, **kwargs: Any) -> AsyncPostgresSaver:
+    """Return the process-wide AsyncPostgresSaver (requires setup_checkpointer)."""
+    if _CHECKPOINTER is None:
+        raise RuntimeError(
+            "Checkpointer not initialized; call start_pool()/setup_checkpointer() first "
+            "(DATABASE_URI required)"
+        )
+    return _CHECKPOINTER
+
+
+__all__ = ["Checkpointer", "setup_checkpointer", "teardown_checkpointer"]