langgraph-api 0.1.1

Rust Client API of LangGraph
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99

# langgraph-api

[![Build](https://github.com/nurokhq/langgraph-api-rust/actions/workflows/build.yml/badge.svg)](https://github.com/nurokhq/langgraph-api-rust/actions/workflows/build.yml)
[![Rust](https://img.shields.io/badge/rust-1.85+-blue.svg)](https://www.rust-lang.org/)
[![Code style: rustfmt](https://img.shields.io/badge/code%20style-rustfmt-000000.svg)](https://github.com/rust-lang/rustfmt)
[![Linter: clippy](https://img.shields.io/badge/linter-clippy-blue.svg)](https://github.com/rust-lang/rust-clippy)

Rust API Client SDK for [LangGraph API](https://langchain-ai.github.io/langgraph/cloud/reference/api/api_ref.html)

## Overview

This is an auto-generated Rust client library for the LangGraph API. It provides type-safe bindings for interacting with LangGraph Cloud, which enables building and running stateful, multi-actor applications with LLMs.

## Features

- **Type-safe API client**: Auto-generated from OpenAPI specification
- **Async/await support**: Built on `reqwest` with async/await
- **Flexible TLS backends**: Choose between `rustls-tls` (default) or `native-tls`
- **Comprehensive API coverage**: Full support for all LangGraph endpoints including:
  - Assistant management (create, search, versioning, graph inspection)
  - Thread and conversation management
  - Run execution (stateful and stateless, with streaming support)
  - Scheduled runs with cron jobs
  - Key-value store operations
  - Agent-to-Agent Protocol (A2A) communication
  - Model Context Protocol (MCP) support
  - System operations (health checks, server info, metrics)

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
langgraph-api = { version = "0.1.1", features = ["rustls-tls"] }
```

Or with native TLS:

```toml
[dependencies]
langgraph-api = { version = "0.1.1", features = ["native-tls"] }
```

## Version Compatibility

The following table shows the version correspondence between the client and LangGraph API:

| Client Version | LangGraph API Version |
|----------------|-------------------|
| 0.1.0          | 0.1.0             |
| 0.1.1          | 0.1.0             |

Please ensure you use a compatible client version for your LangGraph API version to avoid compatibility issues.

## Usage

```rust
use langgraph_api::apis::*;
use langgraph_api::models::*;
...
```

## Features

- `default`: Enables `rustls-tls` feature
- `rustls-tls`: Use rustls for TLS (default, recommended)
- `native-tls`: Use native TLS implementation

## Development

This SDK is generated from the OpenAPI specification using [OpenAPI Generator](https://openapi-generator.tech).

To regenerate the SDK:

```bash
./scripts/generate_api_sdk.sh
```

This script:
1. Generates the SDK from `api/langgraph-openapi.json`
2. Copies the generated code to `src/generated/`
3. Formats the code with `cargo fmt`

## Requirements

- Rust 1.85 or later
- OpenAPI Generator CLI (for regeneration)

## License

See [LICENSE](LICENSE) file for details.

## Contributing

Contributions are welcome! Please ensure that:
- Code is formatted with `cargo fmt`
- All tests pass with `cargo test`
- Clippy checks pass with `cargo clippy`