@langchain/langgraph
Version:
88 lines (87 loc) • 2.66 kB
TypeScript
import { BaseMessage } from "@langchain/core/messages";
import { z } from "zod";
import { Messages } from "./message.js";
/**
* Prebuilt state annotation that combines returned messages.
* Can handle standard messages and special modifiers like {@link RemoveMessage}
* instances.
*
* Specifically, importing and using the prebuilt MessagesAnnotation like this:
*
* @example
* ```ts
* import { MessagesAnnotation, StateGraph } from "@langchain/langgraph";
*
* const graph = new StateGraph(MessagesAnnotation)
* .addNode(...)
* ...
* ```
*
* Is equivalent to initializing your state manually like this:
*
* @example
* ```ts
* import { BaseMessage } from "@langchain/core/messages";
* import { Annotation, StateGraph, messagesStateReducer } from "@langchain/langgraph";
*
* export const StateAnnotation = Annotation.Root({
* messages: Annotation<BaseMessage[]>({
* reducer: messagesStateReducer,
* default: () => [],
* }),
* });
*
* const graph = new StateGraph(StateAnnotation)
* .addNode(...)
* ...
* ```
*/
export declare const MessagesAnnotation: import("./annotation.js").AnnotationRoot<{
messages: import("../web.js").BinaryOperatorAggregate<BaseMessage[], Messages>;
}>;
/**
* Prebuilt state object that uses Zod to combine returned messages.
* This utility is synonymous with the `MessagesAnnotation` annotation,
* but uses Zod as the way to express messages state.
*
* You can use import and use this prebuilt schema like this:
*
* @example
* ```ts
* import { MessagesZodState, StateGraph } from "@langchain/langgraph";
*
* const graph = new StateGraph(MessagesZodState)
* .addNode(...)
* ...
* ```
*
* Which is equivalent to initializing the schema object manually like this:
*
* @example
* ```ts
* import { z } from "zod";
* import type { BaseMessage, BaseMessageLike } from "@langchain/core/messages";
* import { StateGraph, messagesStateReducer } from "@langchain/langgraph";
* import "@langchain/langgraph/zod";
*
* const AgentState = z.object({
* messages: z
* .custom<BaseMessage[]>()
* .default(() => [])
* .langgraph.reducer(
* messagesStateReducer,
* z.custom<BaseMessageLike | BaseMessageLike[]>()
* ),
* });
* const graph = new StateGraph(AgentState)
* .addNode(...)
* ...
* ```
*/
export declare const MessagesZodState: z.ZodObject<{
messages: import("./zod/meta.js").ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, import("@langchain/core/utils/types").InteropZodType<Messages>>;
}, "strip", z.ZodTypeAny, {
messages: BaseMessage[];
}, {
messages: BaseMessage[];
}>;