langchain-ai/langgraphjs
1
0
Fork 0
mirror of https://github.com/langchain-ai/langgraphjs.git synced 2026-07-23 01:26:57 -04:00
Code Issues 108 Packages Projects Releases 20 Wiki Activity

[PR #1087] [CLOSED] feat(checkpoint-bedrock): Add bedrock checkpointer #1228

New Issue
Closed
opened 2026-02-15 19:17:44 -05:00 by yindo · 0 comments
yindo commented 2026-02-15 19:17:44 -05:00
Owner
Copy Link
Copy Source

📋 Pull Request Information

Original PR: https://github.com/langchain-ai/langgraphjs/pull/1087
Author: @cwoolum
Created: 4/7/2025
Status: ❌ Closed

Base: main ← Head: main

📝 Commits (2)

  • 3fba933 feat(checkpoint-bedrock): Add bedrock checkpointer
  • 9a806ac fix: properly filter task writes

📊 Changes

22 files changed (+3218 additions, -122 deletions)

View changed files

➕ libs/checkpoint-bedrock/.env.example (+6 -0)
➕ libs/checkpoint-bedrock/.eslintrc.cjs (+69 -0)
➕ libs/checkpoint-bedrock/.gitignore (+7 -0)
➕ libs/checkpoint-bedrock/.prettierrc (+19 -0)
➕ libs/checkpoint-bedrock/.release-it.json (+13 -0)
➕ libs/checkpoint-bedrock/LICENSE (+21 -0)
➕ libs/checkpoint-bedrock/README.md (+132 -0)
➕ libs/checkpoint-bedrock/jest.config.cjs (+20 -0)
➕ libs/checkpoint-bedrock/jest.env.cjs (+12 -0)
➕ libs/checkpoint-bedrock/langchain.config.js (+21 -0)
➕ libs/checkpoint-bedrock/package.json (+93 -0)
➕ libs/checkpoint-bedrock/src/constants.ts (+4 -0)
➕ libs/checkpoint-bedrock/src/index.ts (+3 -0)
➕ libs/checkpoint-bedrock/src/models.ts (+119 -0)
➕ libs/checkpoint-bedrock/src/saver.ts (+566 -0)
➕ libs/checkpoint-bedrock/src/tests/checkpoints.int.test.ts (+170 -0)
➕ libs/checkpoint-bedrock/src/utils.test.ts (+111 -0)
➕ libs/checkpoint-bedrock/src/utils.ts (+443 -0)
➕ libs/checkpoint-bedrock/tsconfig.cjs.json (+8 -0)
➕ libs/checkpoint-bedrock/tsconfig.json (+37 -0)

...and 2 more files

📄 Description

Overview

This PR introduces a new package @langchain/langgraph-checkpoint-bedrock that implements a CheckpointSaver for LangGraph.js using Amazon Bedrock Agent Runtime sessions for persistence. This implementation allows LangGraph applications to securely store and retrieve conversation state and context across multi-step generative AI workflows without requiring custom backend solutions.

Features

• Implements BedrockSessionSaver class that extends BaseCheckpointSaver from LangGraph
• Provides seamless integration with Amazon Bedrock Agent Runtime sessions API
• Supports storing and retrieving checkpoint data with proper serialization
• Handles pending writes and task sends for complex workflow states
• Implements checkpoint listing with filtering capabilities
• Supports session creation with optional customer-managed KMS keys for enhanced security
• Provides flexible AWS credential configuration options

Implementation Details

• Uses Amazon Bedrock Agent Runtime sessions to store LangGraph checkpoints
• Implements the full CheckpointSaver interface including put, getTuple, putWrites, and list methods
• Organizes checkpoint data using invocations and invocation steps in Bedrock sessions
• Handles serialization/deserialization of complex checkpoint data structures
• Implements proper error handling for AWS service exceptions
• Provides utility functions for AWS configuration and checkpoint management

Security Considerations

• Supports AWS IAM for access control to session data
• Implements optional customer-managed KMS key encryption
• Follows AWS best practices for credential management

Testing

• Includes unit tests for utility functions
• Provides integration tests for the full checkpoint lifecycle

Documentation

• Comprehensive README with installation and usage instructions
• Code examples for common use cases
• Detailed JSDoc comments for all public APIs

Dependencies

• Requires @aws-sdk/client-bedrock-agent-runtime as a peer dependency

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/langchain-ai/langgraphjs/pull/1087 **Author:** [@cwoolum](https://github.com/cwoolum) **Created:** 4/7/2025 **Status:** ❌ Closed **Base:** `main` ← **Head:** `main` --- ### 📝 Commits (2) - [`3fba933`](https://github.com/langchain-ai/langgraphjs/commit/3fba9336acfe80bda2e207e8557ece833f053a4e) feat(checkpoint-bedrock): Add bedrock checkpointer - [`9a806ac`](https://github.com/langchain-ai/langgraphjs/commit/9a806acce2d1eadad87f3c143e418245c1268a6d) fix: properly filter task writes ### 📊 Changes **22 files changed** (+3218 additions, -122 deletions) <details> <summary>View changed files</summary> ➕ `libs/checkpoint-bedrock/.env.example` (+6 -0) ➕ `libs/checkpoint-bedrock/.eslintrc.cjs` (+69 -0) ➕ `libs/checkpoint-bedrock/.gitignore` (+7 -0) ➕ `libs/checkpoint-bedrock/.prettierrc` (+19 -0) ➕ `libs/checkpoint-bedrock/.release-it.json` (+13 -0) ➕ `libs/checkpoint-bedrock/LICENSE` (+21 -0) ➕ `libs/checkpoint-bedrock/README.md` (+132 -0) ➕ `libs/checkpoint-bedrock/jest.config.cjs` (+20 -0) ➕ `libs/checkpoint-bedrock/jest.env.cjs` (+12 -0) ➕ `libs/checkpoint-bedrock/langchain.config.js` (+21 -0) ➕ `libs/checkpoint-bedrock/package.json` (+93 -0) ➕ `libs/checkpoint-bedrock/src/constants.ts` (+4 -0) ➕ `libs/checkpoint-bedrock/src/index.ts` (+3 -0) ➕ `libs/checkpoint-bedrock/src/models.ts` (+119 -0) ➕ `libs/checkpoint-bedrock/src/saver.ts` (+566 -0) ➕ `libs/checkpoint-bedrock/src/tests/checkpoints.int.test.ts` (+170 -0) ➕ `libs/checkpoint-bedrock/src/utils.test.ts` (+111 -0) ➕ `libs/checkpoint-bedrock/src/utils.ts` (+443 -0) ➕ `libs/checkpoint-bedrock/tsconfig.cjs.json` (+8 -0) ➕ `libs/checkpoint-bedrock/tsconfig.json` (+37 -0) _...and 2 more files_ </details> ### 📄 Description ## Overview This PR introduces a new package `@langchain/langgraph-checkpoint-bedrock` that implements a CheckpointSaver for LangGraph.js using Amazon Bedrock Agent Runtime sessions for persistence. This implementation allows LangGraph applications to securely store and retrieve conversation state and context across multi-step generative AI workflows without requiring custom backend solutions. ## Features • Implements BedrockSessionSaver class that extends BaseCheckpointSaver from LangGraph • Provides seamless integration with Amazon Bedrock Agent Runtime sessions API • Supports storing and retrieving checkpoint data with proper serialization • Handles pending writes and task sends for complex workflow states • Implements checkpoint listing with filtering capabilities • Supports session creation with optional customer-managed KMS keys for enhanced security • Provides flexible AWS credential configuration options ## Implementation Details • Uses Amazon Bedrock Agent Runtime sessions to store LangGraph checkpoints • Implements the full CheckpointSaver interface including put, getTuple, putWrites, and list methods • Organizes checkpoint data using invocations and invocation steps in Bedrock sessions • Handles serialization/deserialization of complex checkpoint data structures • Implements proper error handling for AWS service exceptions • Provides utility functions for AWS configuration and checkpoint management ## Security Considerations • Supports AWS IAM for access control to session data • Implements optional customer-managed KMS key encryption • Follows AWS best practices for credential management ## Testing • Includes unit tests for utility functions • Provides integration tests for the full checkpoint lifecycle ## Documentation • Comprehensive README with installation and usage instructions • Code examples for common use cases • Detailed JSDoc comments for all public APIs ## Dependencies • Requires @aws-sdk/client-bedrock-agent-runtime as a peer dependency --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
yindo added the pull-request label 2026-02-15 19:17:44 -05:00
yindo closed this issue 2026-02-15 19:17:44 -05:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
checkpointer
docs-needed
documentation
enhancement
good first issue
good writeup
help wanted
invalid
langgraph-supervisor
open-swe-auto
platform
prebuilt
pull-request
Mirrored from GitHub Pull Request
 question
No Label pull-request
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langchain-ai/langgraphjs#1228
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?