[Langgraph Checkpoint Saver] Introduce langgraph checkpoint saver backed by ES database #228997

KDKHD · 2025-07-22T17:00:06Z

Summary

Summarize your PR. If it involves visual changes include a screenshot or gif.

This PR introduces a new shared platform package containing a langgraph checkpointer backed by elastic search.

Considerations

An alternative approach explored is building the langgraph checkpointer directly inside of the langgraph repo. We chose not to do that, as we would first like to ensure our implementation is mature enough for public use before open-sourcing it to the LangGraph community.

Checklist

Check the PR satisfies following conditions.

Reviewers should verify this PR satisfies this list as well.

Any text added follows EUI's writing guidelines, uses sentence case text and includes i18n support
Documentation was added for features that require explanation or tutorials
Unit or functional tests were updated or added to match the most common scenarios
If a plugin configuration key changed, check if it needs to be allowlisted in the cloud and added to the docker list
This was checked for breaking HTTP API changes, and any breaking changes have been approved by the breaking-change committee. The release_note:breaking label should be applied in these situations.
Flaky Test Runner was used on any tests changed
The PR description includes the appropriate Release Notes section, and the correct release_note:* label is applied per the guidelines
Review the backport guidelines and apply applicable backport:* labels.

Identify risks

Does this PR introduce any risks? For example, consider risks like hard to test bugs, performance regression, potential of data loss.

Describe the risk, its severity, and mitigation for each identified risk. Invite stakeholders and evaluate how to proceed before merging.

See some risk examples
...

kibanamachine · 2025-07-22T17:00:31Z

Dependency Review Bot Analysis 🔍

Found 1 new third-party dependencies:

Package	Version	Vulnerabilities	Health Score
@langchain/langgraph-checkpoint	~0.0.17	🔴 C: 0, 🟠 H: 0, 🟡 M: 0, 🟢 L: 0

Self Checklist

To help with the review, please update the PR description to address the following points for each new third-party dependency listed above:

Purpose: What is this dependency used for? Briefly explain its role in your changes.
Justification: Why is adding this dependency the best approach?
Alternatives explored: Were other options considered (e.g., using existing internal libraries/utilities, implementing the functionality directly)? If so, why was this dependency chosen over them?
Existing dependencies: Does Kibana have a dependency providing similar functionality? If so, why is the new one preferred?

Thank you for providing this information!

KDKHD · 2025-07-22T17:05:23Z

@elasticmachine merge upstream

…ana into feature/langgraph-checkpointer

KDKHD · 2025-07-22T17:14:52Z

Checklist @langchain/langgraph-checkpoint

Purpose: What is this dependency used for? Briefly explain its role in your changes.

The newly added dependency allows us to implement a langgraph checkpointer backed by Elastic Search. An Elastic search checkpointer allows us to develop human-in-the-loop flows using the langgraph framework.

Justification: Why is adding this dependency the best approach?

The dependency needed to be added in order to support building a langgraph checkpointer backed by Elastic Search.

Alternatives explored: Were other options considered (e.g., using existing internal libraries/utilities, implementing the functionality directly)? If so, why was this dependency chosen over them?

Since we are creating a new implementation of BaseCheckpointSaver, and BaseCheckpointSaver is part of the @langchain/langgraph-checkpoint package, this is the only approach.

Existing dependencies: Does Kibana have a dependency providing similar functionality? If so, why is the new one preferred?

No, this is new functionality in Kibana.

…t --include-path /api/status --include-path /api/alerting/rule/ --include-path /api/alerting/rules --include-path /api/actions --include-path /api/security/role --include-path /api/spaces --include-path /api/streams --include-path /api/fleet --include-path /api/dashboards --include-path /api/saved_objects/_import --include-path /api/saved_objects/_export --include-path /api/maintenance_window --update'

…no-cache --fix'

KDKHD · 2025-07-23T07:37:01Z

...ckages/shared/kbn-langgraph-checkpoint-saver/server/elastic-search-checkpoint-saver/index.ts

+    const [checkpointType, serializedCheckpoint] = this.serde.dumpsTyped(checkpoint);
+    const [metadataType, serializedMetadata] = this.serde.dumpsTyped(metadata);


We need to serialize the data because the BaseCheckpointSaver has unknown types defined for checkpoint and metadata. This implies that the shape of these objects can vary, and only through serialization can we ensure the data is persisted correctly.

KDKHD · 2025-07-23T07:42:34Z

...er/elastic-search-checkpoint-saver/integration_tests/elastic_search_checkpoint_saver.test.ts

+import { Checkpoint, CheckpointTuple, uuid6 } from '@langchain/langgraph-checkpoint';
+
+// Define test checkpoints
+const checkpoint1: Checkpoint = {


Test adapted from sample test in langgraph repo https://github.com/langchain-ai/langgraphjs/blob/4be3c418cbe3493522bdf761b541bf51a1f9faf6/libs/checkpoint-mongodb/src/tests/checkpoints.int.test.ts

…no-cache --fix'

elena-shostak

@langchain/langgraph-checkpoint dependency LGTM ✅

…ibana into feature/langgraph-checkpointer

KDKHD · 2025-07-29T12:00:54Z

@elasticmachine merge upstream

elasticmachine · 2025-07-29T12:00:57Z

merge conflict between base and head

…no-cache --fix'

KDKHD · 2025-07-31T15:09:31Z

@elasticmachine merge upstream

elasticmachine · 2025-07-31T17:27:52Z

💚 Build Succeeded

Buildkite Build
Commit: 0ad373b

Metrics [docs]

✅ unchanged