langgraph-api 0.0.1__tar.gz → 0.0.3__tar.gz

langgraph_api-0.0.3/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.1
+Name: langgraph-api
+Version: 0.0.3
+Summary: 
+License: Elastic-2.0
+Author: Nuno Campos
+Author-email: nuno@langchain.dev
+Requires-Python: >=3.11.0,<4.0
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: cryptography (>=43.0.3,<44.0.0)
+Requires-Dist: httpx (>=0.27.0)
+Requires-Dist: jsonschema-rs (>=0.25.0,<0.26.0)
+Requires-Dist: langchain-core (>=0.2.38,<0.4.0)
+Requires-Dist: langgraph (>=0.2.52,<0.3.0)
+Requires-Dist: langgraph-checkpoint (>=2.0.5,<3.0)
+Requires-Dist: langsmith (>=0.1.63,<0.2.0)
+Requires-Dist: orjson (>=3.10.1)
+Requires-Dist: pyjwt (>=2.9.0,<3.0.0)
+Requires-Dist: sse-starlette (>=2.1.0,<3.0.0)
+Requires-Dist: starlette (>=0.38.6)
+Requires-Dist: structlog (>=24.4.0,<25.0.0)
+Requires-Dist: tenacity (>=8.3.0,<9.0.0)
+Requires-Dist: uvicorn (>=0.26.0)
+Requires-Dist: watchfiles (>=0.13)
+Description-Content-Type: text/markdown
+
+# LangGraph API
+
+This package implements the LangGraph API for rapid development and testing. Build and iterate on LangGraph agents with a tight feedback loop. The sesrver is backed by a predominently in-memory data store that is persisted to local disk when the server is restarted.
+
+For production use, see the various [deployment options](https://langchain-ai.github.io/langgraph/concepts/deployment_options/) for the LangGraph API, which are backed by a production-grade database.
+
+## Installation
+
+Install the `langgraph-cli` package with the `inmem` extra. Your CLI version must be no lower than `0.1.55`.
+
+```bash
+pip install -U langgraph-cli[inmem]
+```
+
+## Quickstart
+
+1. (Optional) Clone a starter template:
+
+   ```bash
+   langgraph new --template new-langgraph-project-python ./my-project
+   cd my-project
+   ```
+
+   (Recommended) Use a virtual environment and install dependencies:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   python -m pip install .
+   ```
+
+2. Start the development server:
+
+   ```shell
+   langgraph dev --config ./langgraph.json
+   ```
+
+3. The server will launch, opening a browser window with the graph UI. Interact with your graph or make code edits; the server automatically reloads on changes.
+
+## Usage
+
+Start the development server:
+
+```bash
+langgraph dev
+```
+
+Your agent's state (threads, runs, assistants) persists in memory while the server is running - perfect for development and testing. Each run's state is tracked and can be inspected, making it easy to debug and improve your agent's behavior.
+
+## How-To
+
+#### Attaching a debugger
+Debug mode lets you attach your IDE's debugger to the LangGraph API server to set breakpoints and step through your code line-by-line.
+
+1. Install debugpy:
+
+   ```bash
+   pip install debugpy
+   ```
+
+2. Start the server in debug mode:
+
+   ```bash
+   langgraph dev --debug-port 5678
+   ```
+
+3. Configure your IDE:
+
+   - **VS Code**: Add this launch configuration:
+     ```json
+     {
+       "name": "Attach to LangGraph",
+       "type": "debugpy",
+       "request": "attach",
+       "connect": {
+                "host": "0.0.0.0",
+                "port": 5678
+            },
+     }
+     ```
+   - **PyCharm**: Use "Attach to Process" and select the langgraph process
+
+4. Set breakpoints in your graph code and start debugging.
+
+## CLI options
+
+```bash
+langgraph dev [OPTIONS]
+Options:
+  --debug-port INTEGER         Enable remote debugging on specified port
+  --no-browser                 Skip opening browser on startup
+  --n-jobs-per-worker INTEGER  Maximum concurrent jobs per worker process
+  --config PATH               Custom configuration file path
+  --no-reload                 Disable code hot reloading
+  --port INTEGER              HTTP server port (default: 8000)
+  --host TEXT                 HTTP server host (default: localhost)
+```
+
+## License
+
+This project is licensed under the Elastic License 2.0 - see the [LICENSE](./LICENSE) file for details.

langgraph_api-0.0.3/README.md

@@ -0,0 +1,101 @@
+# LangGraph API
+
+This package implements the LangGraph API for rapid development and testing. Build and iterate on LangGraph agents with a tight feedback loop. The sesrver is backed by a predominently in-memory data store that is persisted to local disk when the server is restarted.
+
+For production use, see the various [deployment options](https://langchain-ai.github.io/langgraph/concepts/deployment_options/) for the LangGraph API, which are backed by a production-grade database.
+
+## Installation
+
+Install the `langgraph-cli` package with the `inmem` extra. Your CLI version must be no lower than `0.1.55`.
+
+```bash
+pip install -U langgraph-cli[inmem]
+```
+
+## Quickstart
+
+1. (Optional) Clone a starter template:
+
+   ```bash
+   langgraph new --template new-langgraph-project-python ./my-project
+   cd my-project
+   ```
+
+   (Recommended) Use a virtual environment and install dependencies:
+
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   python -m pip install .
+   ```
+
+2. Start the development server:
+
+   ```shell
+   langgraph dev --config ./langgraph.json
+   ```
+
+3. The server will launch, opening a browser window with the graph UI. Interact with your graph or make code edits; the server automatically reloads on changes.
+
+## Usage
+
+Start the development server:
+
+```bash
+langgraph dev
+```
+
+Your agent's state (threads, runs, assistants) persists in memory while the server is running - perfect for development and testing. Each run's state is tracked and can be inspected, making it easy to debug and improve your agent's behavior.
+
+## How-To
+
+#### Attaching a debugger
+Debug mode lets you attach your IDE's debugger to the LangGraph API server to set breakpoints and step through your code line-by-line.
+
+1. Install debugpy:
+
+   ```bash
+   pip install debugpy
+   ```
+
+2. Start the server in debug mode:
+
+   ```bash
+   langgraph dev --debug-port 5678
+   ```
+
+3. Configure your IDE:
+
+   - **VS Code**: Add this launch configuration:
+     ```json
+     {
+       "name": "Attach to LangGraph",
+       "type": "debugpy",
+       "request": "attach",
+       "connect": {
+                "host": "0.0.0.0",
+                "port": 5678
+            },
+     }
+     ```
+   - **PyCharm**: Use "Attach to Process" and select the langgraph process
+
+4. Set breakpoints in your graph code and start debugging.
+
+## CLI options
+
+```bash
+langgraph dev [OPTIONS]
+Options:
+  --debug-port INTEGER         Enable remote debugging on specified port
+  --no-browser                 Skip opening browser on startup
+  --n-jobs-per-worker INTEGER  Maximum concurrent jobs per worker process
+  --config PATH               Custom configuration file path
+  --no-reload                 Disable code hot reloading
+  --port INTEGER              HTTP server port (default: 8000)
+  --host TEXT                 HTTP server host (default: localhost)
+```
+
+## License
+
+This project is licensed under the Elastic License 2.0 - see the [LICENSE](./LICENSE) file for details.

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/cli.py

@@ -4,7 +4,7 @@ import logging
 import os
 import pathlib
 import threading
-from collections.abc import Mapping
+from collections.abc import Mapping, Sequence
 
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
@@ -47,6 +47,8 @@ def run_server(
     open_browser: bool = False,
     debug_port: int | None = None,
     env: str | pathlib.Path | Mapping[str, str] | None = None,
+    reload_includes: Sequence[str] | None = None,
+    reload_excludes: Sequence[str] | None = None,
 ):
     """Run the LangGraph API server."""
     import uvicorn
@@ -127,7 +129,7 @@ For production use, please use LangGraph Cloud.
         REDIS_URI="fake",
         N_JOBS_PER_WORKER=str(n_jobs_per_worker if n_jobs_per_worker else 1),
         LANGSERVE_GRAPHS=json.dumps(graphs) if graphs else None,
-        LANGSMITH_LANGGRAPH_API_VARIANT="test",
+        LANGSMITH_LANGGRAPH_API_VARIANT="local_dev",
         **(env_vars or {}),
     ):
         if open_browser:
@@ -140,13 +142,13 @@ For production use, please use LangGraph Cloud.
             reload=reload,
             env_file=env_file,
             access_log=False,
+            reload_includes=reload_includes,
+            reload_excludes=reload_excludes,
             log_config={
                 "version": 1,
                 "incremental": False,
                 "disable_existing_loggers": False,
-                "formatters": {
-                    "simple": {"class": "langgraph_api.logging.Formatter"}
-                },
+                "formatters": {"simple": {"class": "langgraph_api.logging.Formatter"}},
                 "handlers": {
                     "console": {
                         "class": "logging.StreamHandler",

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/graph.py

@@ -157,18 +157,20 @@ async def collect_graphs_from_env(register: bool = False) -> None:
 
     if paths_str:
         specs = [
-            GraphSpec(
-                key,
-                module=value.split(":")[0],
-                variable=value.split(":")[1],
-                config=config_per_graph.get(key),
-            )
-            if "/" not in value
-            else GraphSpec(
-                key,
-                path=value.split(":")[0],
-                variable=value.split(":")[1],
-                config=config_per_graph.get(key),
+            (
+                GraphSpec(
+                    key,
+                    module=value.split(":")[0],
+                    variable=value.split(":")[1],
+                    config=config_per_graph.get(key),
+                )
+                if "/" not in value
+                else GraphSpec(
+                    key,
+                    path=value.split(":")[0],
+                    variable=value.split(":")[1],
+                    config=config_per_graph.get(key),
+                )
             )
             for key, value in json.loads(paths_str).items()
         ]
@@ -268,7 +270,15 @@ def _graph_from_spec(spec: GraphSpec) -> GraphValue:
             modspec.loader.exec_module(module)
         except ImportError as e:
             e.add_note(f"Could not import python module for graph: {spec}")
-            raise e
+            if os.environ.get("LANGSMITH_LANGGRAPH_API_VARIANT") == "local_dev":
+                e.add_note(
+                    "This error likely means you haven't installed your project and its dependencies yet. Before running the server, install your project:\n\n"
+                    "If you are using requirements.txt:\n"
+                    "python -m pip install -r requirements.txt\n\n"
+                    "If you are using pyproject.toml or setuptools:\n"
+                    "python -m pip install -e .\n\n"
+                    "Make sure to run this command from your project's root directory (where your setup.py or pyproject.toml is located)"
+                )
     else:
         raise ValueError("Graph specification must have a path or module")
 

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/js/src/hooks.mjs

@@ -5,7 +5,11 @@ export async function resolve(specifier, context, nextResolve) {
   const parentURL = new URL("./graph.mts", import.meta.url).toString();
 
   if (specifier.startsWith("@langchain/langgraph")) {
-    return nextResolve(specifier, { ...context, parentURL });
+    try {
+      return nextResolve(specifier, { ...context, parentURL });
+    } catch (error) {
+      return nextResolve(specifier, context);
+    }
   }
 
   return nextResolve(specifier, context);

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/queue.py

@@ -5,7 +5,7 @@ from random import random
 from typing import cast
 
 import structlog
-from langgraph.pregel.debug import CheckpointPayload
+from langgraph.pregel.debug import CheckpointPayload, TaskResultPayload
 
 from langgraph_api.config import BG_JOB_NO_DELAY, STATS_INTERVAL_SECS
 from langgraph_api.errors import (
@@ -129,6 +129,13 @@ async def worker(
             nonlocal checkpoint
             checkpoint = checkpoint_arg
 
+        def on_task_result(task_result: TaskResultPayload):
+            if checkpoint is not None:
+                for task in checkpoint["tasks"]:
+                    if task["id"] == task_result["id"]:
+                        task.update(task_result)
+                        break
+
         try:
             if attempt > MAX_RETRY_ATTEMPTS:
                 raise RuntimeError(f"Run {run['run_id']} exceeded max attempts")
@@ -144,6 +151,7 @@ async def worker(
                     attempt,
                     done,
                     on_checkpoint=on_checkpoint,
+                    on_task_result=on_task_result,
                 )
             await asyncio.wait_for(consume(stream, run_id), timeout)
             await logger.ainfo(

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/schema.py

@@ -98,6 +98,8 @@ class Thread(TypedDict):
     """The status of the thread. One of 'idle', 'busy', 'interrupted', "error"."""
     values: Fragment
     """The current state of the thread."""
+    interrupts: Fragment
+    """The current interrupts of the thread, a map of task_id to list of interrupts."""
 
 
 class ThreadTask(TypedDict):

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_api/stream.py

@@ -18,7 +18,7 @@ from langgraph.errors import (
     GraphRecursionError,
     InvalidUpdateError,
 )
-from langgraph.pregel.debug import CheckpointPayload
+from langgraph.pregel.debug import CheckpointPayload, TaskResultPayload
 from langgraph.types import Command, Send
 from pydantic import ValidationError
 from pydantic.v1 import ValidationError as ValidationErrorLegacy
@@ -90,6 +90,7 @@ async def astream_state(
     done: ValueEvent,
     *,
     on_checkpoint: Callable[[CheckpointPayload], None] = lambda _: None,
+    on_task_result: Callable[[TaskResultPayload], None] = lambda _: None,
 ) -> AnyStream:
     """Stream messages from the runnable."""
     run_id = str(run["run_id"])
@@ -174,6 +175,8 @@ async def astream_state(
                         if chunk["type"] == "checkpoint":
                             checkpoint = _preprocess_debug_checkpoint(chunk["payload"])
                             on_checkpoint(checkpoint)
+                        elif chunk["type"] == "task_result":
+                            on_task_result(chunk["payload"])
                     if mode == "messages":
                         if "messages-tuple" in stream_mode:
                             yield "messages", chunk
@@ -221,6 +224,8 @@ async def astream_state(
                     if chunk["type"] == "checkpoint":
                         checkpoint = _preprocess_debug_checkpoint(chunk["payload"])
                         on_checkpoint(checkpoint)
+                    elif chunk["type"] == "task_result":
+                        on_task_result(chunk["payload"])
                 if mode == "messages":
                     if "messages-tuple" in stream_mode:
                         yield "messages", chunk

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_license/validation.py

@@ -7,5 +7,5 @@ async def get_license_status() -> bool:
 
 
 def plus_features_enabled() -> bool:
-    """Always return true"""
+    """Always return false"""
     return False

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_storage/checkpoint.py

@@ -10,6 +10,8 @@ from langgraph.checkpoint.base import (
 )
 from langgraph.checkpoint.memory import MemorySaver, PersistentDict
 
+from langgraph_api.serde import Serializer
+
 _EXCLUDED_KEYS = {"checkpoint_ns", "checkpoint_id", "run_id", "thread_id"}
 
 
@@ -37,7 +39,7 @@ class InMemorySaver(MemorySaver):
             return d
 
         super().__init__(
-            serde=serde,
+            serde=serde if serde is not None else Serializer(),
             factory=factory,
         )
 

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/langgraph_storage/ops.py

@@ -583,6 +583,15 @@ class Threads:
                 "updated_at": datetime.now(UTC),
                 "values": checkpoint["values"] if checkpoint else None,
                 "status": status,
+                "interrupts": (
+                    {
+                        t["id"]: t["interrupts"]
+                        for t in checkpoint["tasks"]
+                        if t["interrupts"]
+                    }
+                    if checkpoint
+                    else {}
+                ),
             }
         )
 

{langgraph_api-0.0.1 → langgraph_api-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "langgraph-api"
-version = "0.0.1"
+version = "0.0.3"
 description = ""
 authors = [
     "Nuno Campos <nuno@langchain.dev>",
@@ -12,6 +12,7 @@ packages = [
     { include = "langgraph_storage" },
     { include = "langgraph_license" },
 ]
+readme = "README.md"
 include = ["LICENSE", "openapi.json", "logging.json"]
 
 [tool.poetry.scripts]
@@ -22,7 +23,8 @@ python = ">=3.11.0,<4.0"
 sse-starlette = "^2.1.0"
 starlette = ">=0.38.6"
 watchfiles = ">=0.13"
-langgraph = ">=0.2.52"
+langgraph = ">=0.2.52,<0.3.0"
+langgraph-checkpoint = ">=2.0.5,<3.0"
 orjson = ">=3.10.1"
 uvicorn = ">=0.26.0"
 langsmith = "^0.1.63"

langgraph_api-0.0.1/PKG-INFO

@@ -1,26 +0,0 @@
-Metadata-Version: 2.1
-Name: langgraph-api
-Version: 0.0.1
-Summary: 
-License: Elastic-2.0
-Author: Nuno Campos
-Author-email: nuno@langchain.dev
-Requires-Python: >=3.11.0,<4.0
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: cryptography (>=43.0.3,<44.0.0)
-Requires-Dist: httpx (>=0.27.0)
-Requires-Dist: jsonschema-rs (>=0.25.0,<0.26.0)
-Requires-Dist: langchain-core (>=0.2.38,<0.4.0)
-Requires-Dist: langgraph (>=0.2.52)
-Requires-Dist: langsmith (>=0.1.63,<0.2.0)
-Requires-Dist: orjson (>=3.10.1)
-Requires-Dist: pyjwt (>=2.9.0,<3.0.0)
-Requires-Dist: sse-starlette (>=2.1.0,<3.0.0)
-Requires-Dist: starlette (>=0.38.6)
-Requires-Dist: structlog (>=24.4.0,<25.0.0)
-Requires-Dist: tenacity (>=8.3.0,<9.0.0)
-Requires-Dist: uvicorn (>=0.26.0)
-Requires-Dist: watchfiles (>=0.13)