Represents a state field backed by a DeltaChannel.
Unlike ReducedValue (which stores the full accumulated value in every
checkpoint blob via BinaryOperatorAggregate), a DeltaValue field persists
only per-step deltas (plus periodic snapshots) and reconstructs its state on
read by replaying ancestor writes through a batch reducer. This avoids
re-serializing large accumulators (e.g. long message histories) at every step.
Beta. The on-disk representation backing DeltaChannel may change in
future releases.
The schema used to validate reducer inputs. Defaults to valueSchema when
not specified explicitly.
Represents the type that may be provided as input on each update.
The schema that describes the type of value stored in state (after reduction). Its default (if any) seeds the channel's initial value.
Type guard to check if a value is a DeltaValue instance.
import { z } from "zod";
import { StateSchema, DeltaValue } from "@langchain/langgraph";
const State = new StateSchema({
history: new DeltaValue(z.array(z.string()).default(() => []), {
inputSchema: z.string(),
reducer: (current, writes) => [...current, ...writes],
}),
});