UNPKG

@langchain/langgraph

Version:
88 lines (87 loc) 2.66 kB
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[]; }>;