@cloudbase/ag-adapter-langgraph

LangGraph adapter for AG-Kit agents. This package provides integration between AG-Kit and LangGraph framework, enabling you to use LangGraph workflows with AG-Kit's agent infrastructure.

Installation

npm install @cloudbase/ag-agents @cloudbase/ag-adapter-langgraph

Features

• LangGraphAgent: Agent implementation that works with compiled LangGraph workflows
• TDAISaver: Checkpoint saver implementation using TDAI Memory
• TDAIStore: Store implementation for LangGraph using TDAI Memory
• AGKitStateAnnotation: Pre-configured state annotation for AG-Kit integration

Usage

Basic Agent Setup

import { StateGraph, START, END } from "@langchain/langgraph";
import { AGKitStateAnnotation, LanggraphAgent } from "@cloudbase/ag-adapter-langgraph";
import { AgentConfig } from "@cloudbase/ag-agents/abstract";

// Create your LangGraph workflow
const workflow = new StateGraph(AGKitStateAnnotation)
  .addNode("chat_node", chatNode)
  .addEdge(START, "chat_node")
  .addEdge("chat_node", END);

const compiledWorkflow = workflow.compile();

// Create the agent
const agent = new LanggraphAgent({
  name: "my-langgraph-agent",
  description: "A LangGraph agent",
  compiledWorkflow,
});

Using TDAISaver for Checkpoints

import { TDAISaver } from "@cloudbase/ag-adapter-langgraph";
import { MemoryClient } from "@cloudbase/ag-agents";

const memoryClient = new MemoryClient({
  endpoint: "https://api.tdai.com",
  apiKey: "your-api-key",
  memoryId: "your-memory-id",
});

const checkpointer = new TDAISaver({
  endpoint: "https://api.tdai.com",
  apiKey: "your-api-key",
  memoryId: "your-memory-id",
});

const compiledWorkflow = workflow.compile({
  checkpointer,
});

Using TDAIStore

import { TDAIStore } from "@cloudbase/ag-adapter-langgraph";
import { MemoryClient } from "@cloudbase/ag-agents";

const memoryClient = new MemoryClient({
  endpoint: "https://api.tdai.com",
  apiKey: "your-api-key",
  memoryId: "your-memory-id",
});

const store = new TDAIStore({
  memoryClient,
  sessionId: "session-123",
});

API Reference

LanggraphAgent

Agent class that extends AbstractAgent and works with compiled LangGraph workflows.

Constructor:

constructor(config: AgentConfig & { compiledWorkflow: CompiledStateGraph })

TDAISaver

Checkpoint saver implementation for LangGraph using TDAI Memory.

Constructor:

constructor(config: TDAISaverConfig)

TDAIStore

Store implementation for LangGraph using TDAI Memory.

Constructor:

constructor(config: TDAIStoreConfig)

Requirements

• @cloudbase/ag-agents: Core agent functionality
• @langchain/langgraph: LangGraph framework
• @langchain/core: LangChain core utilities
• rxjs: Reactive extensions for JavaScript

Related Resources

• AG-Kit Documentation
• LangGraph Documentation
• AG-Kit Examples