R.7

Glossary

Each term below has one meaning in this manual, and a term that two sections use in two senses lists both, each with its own context.

The meanings come from the code at the pin, the documentation at docs commit 04d4d4a, and the definitions in the sections. Terms in code font are literal names that you type or read in output.

TermMeaning in this manualExplained in
Advisory lockA Postgres lock on a number that your code chooses, held by a session and freed when the session ends.9.7
add_messagesThe reducer for a list of messages. It appends a message with a new id, replaces a message with the same id, and deletes the message that a RemoveMessage names.6.1
Agent ServerThe LangSmith server that runs a compiled graph behind an HTTP API of assistants, threads, and runs. Its package is langgraph-api.8.1
AgentStateThe state type of every agent, with the keys messages, jump_to, and structured_response.4.1
AutoModeMiddlewareA middleware that asks a decision model if a call to a listed tool is risky, and blocks the call at a probability of 0.5 or more.4.8
Batched modeThe default interrupt_mode. One interrupt holds every paused call of one model message, and one resume answers all of them in order.6.5
Built-in middlewareA middleware class that langchain exports from langchain.agents.middleware. There are 19 at the pin.4.6
Capture kitThe program in capture/ that drives the stack in one Python process, offline, and writes what it sees to capture/out/.How to read this manual
Channel versionA number that the loop stores for each channel in the checkpoint. A channel that changes in a superstep gets a new version.2.1
CheckerThe function of the bench that decides a pass from what the tools changed, such as the lookups that ran, the database, the files, and the notes store.The bench method
CheckpointThe saved state of one thread after one step, with the step number, the next nodes, and the id of the checkpoint before it.1.3
Checkpoint tupleWhat a checkpointer returns for one checkpoint: its config, its metadata, the checkpoint, the config of its parent, and its pending writes.5.2
CheckpointerAn object that saves the graph state after each step and loads the latest checkpoint when the next run starts.5.2
Chunk, of a messageA part of a message that a model streams, such as an AIMessageChunk. Chunks add with + into one message.3.3
Chunk, of a streamOne item that stream yields. Its shape depends on the stream mode, the number of modes, and the stream version.5.1
CommandA value that a node returns to update the state and name the next node in one step, with the fields update, goto, graph, and resume.6.2
Conditional edgeAn edge with a routing function, which reads the state after the source node and returns the next node, a list of nodes, or END.6.2
Content blockOne typed part of a message, a dict with a type such as text, reasoning, image, file, or tool_call.3.3
Context engineeringThe choice of what the model receives on each call: which messages, which tools, and which instructions.5.5
Context windowThe most tokens that a model accepts in one call, input and output together.5.5
create_agentThe function in langchain.agents that turns a model, tools, a prompt, and middleware into a CompiledStateGraph.4.1
DecisionThe answer to one paused tool call, with a type of approve, edit, reject, or respond.6.5
Decision modelA BaseDecisionModel from langchain_core.decisions, new in langchain-core 1.8.0, that answers typed questions.4.8
Deep agentAn agent from create_deep_agent in deepagents. It is a create_agent graph with a fixed stack of middleware around your own.7.4
Deep AgentsThe harness project, in the package deepagents, that adds file tools, subagents, and summarization to an agent.1.1
default_retry_onThe default retry_on of both retry middlewares. It retries every Exception except a ModelError whose is_retryable is false.4.7
Delivery delayThe time from the moment the model server sends a token to the moment your loop sees it, on one clock.5.1
DeltaChannelA beta channel type in langgraph.channels.delta that saves only the new writes of each step. It saves a full snapshot after snapshot_frequency updates, 100 by default, or after 5,000 steps.5.5
Distractor toolA tool that a task does not need, with a plausible name and description. The bench has 95 of them.4.4
DistributionA package as pip names it, such as langchain-core. Its import name has _ in place of -.3.1
Double textingA second run on a thread while a first run on that thread is still running.8.1
Durability modeThe durability argument of invoke and stream: sync, async, or exit. It decides when the checkpoints of a run are written.5.3
Embedding modelAn object with embed_query and embed_documents that turns text into a vector of numbers.7.1
EntrypointA function decorated with @entrypoint, which LangGraph runs as a graph with one node.6.3
entrypoint.finalA return value of an entrypoint that splits what the caller gets from what the thread saves.6.3
Error handlerA function that runs after the last failed attempt of a node. It gets the state and a NodeError, and returns an update or a Command.6.8
EvalOne scripted conversation against the running service, followed by assertions on the tool calls, the rows, and the thread state.9.6
EvaluatorA function that scores one row of an experiment and returns a dict with a key and a score.7.7
ExampleOne input with its reference output, as a langsmith.schemas.Example.7.7
ExperimentOne call of evaluate over a set of examples.7.7
Extraction callOne call of with_structured_output after the agent run, which reads the question and the final reply and returns the schema.4.3
Failure categoryThe first matching reason for a failed bench task, such as wrong_tool, wrong_args, or wrong_final_state.The bench method
Failure drillA script that causes each known failure on purpose, on a machine you can lose, and prints what you would see.8.7
FilesystemBackendA backend that maps the file tools of a deep agent to a folder on disk, in place of the agent state.7.4
ForkA new checkpoint whose parent is a past checkpoint. Runs from it form a branch beside the old one.6.6
Framework timeThe wall time of a task minus the time inside the model calls and the tool functions.1.2, 2.6
GraphRunStreamThe object that stream_events(..., version="v3") returns, with raw events and typed views such as messages.5.1
GuardrailA check inside the agent that changes, blocks, or stops a request, a reply, or a tool call.4.8
handle_errorsThe ToolStrategy parameter that sets the retry after a parse error. True, the default, retries on every parse error.4.2
HumanInTheLoopMiddlewareThe middleware that pauses an agent when the model asks for a tool in its interrupt_on map, and waits for a decision.6.5
Idempotency keyA value that names one side effect, so that the effect can check if it already happened and skip itself.5.3
Idempotent toolA tool that gives the same result and the same side effects when you call it twice with the same arguments.9.5
InterruptA call of interrupt(value) inside a node. It stops the run, saves a checkpoint, and gives value to the caller.6.4
ItemOne value in a store, with its namespace, its key, and the times it was created and updated.5.4
Jobs per workerThe number of runs that one queue worker of Agent Server executes at the same time.8.1
jump_toA key that a node hook returns to move the run to model, tools, or end.4.5
Lab recordingA run against a real model or a real database on one of our machines, kept as raw files in capture/lab/.How this manual was made
LangChainThe agent framework, in the packages langchain and langchain-core.1.1
LangGraphThe runtime that runs an agent as a graph of nodes, in the package langgraph.1.1
LangSmithThe hosted platform for traces, evaluations, prompts, and deployments, and its client package langsmith.1.1
max_concurrencyThe key of the run config that caps how many tasks of one step run at the same time.4.1
MCP adapterThe class MCPAdapter in langchain.mcp. It connects to an MCP server through FastMCP and returns its tools as LangChain tools.7.3
MCP tool errorA tool result with isError set to true. A FastMCP server sends one when the tool raises.7.3
MessageOne entry in the conversation, with a type, a content, and an optional id.3.3
MiddlewareAn object of a subclass of AgentMiddleware that create_agent runs at fixed points of the agent loop.4.5
Model profileA dict on model.profile with the limits and features of one model.3.2
Model stringThe text form of a model, such as openai:gpt-4.1, that init_chat_model and create_agent accept.3.2
ModelFallbackMiddlewareThe middleware that calls the next model in its list when a model call raises.4.7
Namespace, of a storeA tuple of strings, such as ("users", "ada", "memories"), that groups the items of a store. Each string is a label.5.4
Namespace, of a subgraphThe path of a subgraph run inside its parent, such as inner:<task id>. Stream chunks, checkpoints, and state carry it.6.7
Node hookA middleware hook that create_agent turns into a graph node. It takes the state and the runtime.4.5
Node timeoutThe timeout of add_node, in seconds, for each attempt of an async node.6.8
Pending writeA value that a task wrote during a step, saved under the checkpoint that the step started from. It can reach the saver after the checkpoint of its own step. A resume applies it and does not run that task again.5.2, 2.3
Per-call modeinterrupt_mode="per_call". Each paused call gets its own interrupt, and a resume answers any of them by interrupt id.6.5
PIIMiddlewareA middleware that finds one type of personal data in messages and applies one strategy to each match.4.8
Plain edgeAn edge that LangGraph follows every time its source node finishes.6.2
ProjectionA typed view of one v3 message, such as message.text, that yields its own deltas.5.1
Python floorThe oldest Python version that a package declares in requires-python.3.1
Recursion limitThe number of steps after which a run raises GraphRecursionError. Each step counts once, whatever number of nodes run in it.6.8
ReducerA function of the old value and an update that returns the new value of one state key.6.1
RemainingStepsA managed value in the state that holds the number of steps left before the limit.6.8
ReplayAn invoke(None, config) where config names a past checkpoint. The nodes in its next run again.6.6
ResumeAn invoke or stream call with Command(resume=value) on the thread of the pause. The interrupt call then returns value.6.4
Resume listThe list of answers that one task has received so far, saved as a write on the channel __resume__.2.4
RetrieverAn object with invoke(query) that returns a list of Document objects, with the base class BaseRetriever.7.1
Resume mapA Command(resume=...) whose value is a dict keyed by interrupt ids. At the pin it goes into the run config only.9.3
Retry layerOne piece of code that calls the model or the tool again after a failure, such as the client of a provider package or ModelRetryMiddleware.3.2, 4.7
RetryPolicyThe settings for running a failed node again: max_attempts, the wait between attempts, and retry_on.6.8
Round tripA value written into a checkpoint and read back. It round-trips when it comes back with the same type and an equal value.5.6
RunOne call of invoke or stream.How to read this manual
Run taskThe asyncio task that iterates agent.astream for one run and puts each event on a queue that the response reads.9.1
Run treeThe in-memory object of one traced run, RunTree in langsmith.7.6
SendA value that names a node and the input of one run of it. A list of them from a routing function starts one task for each.6.2
SerializerThe object that turns state values into bytes for a checkpointer and back. The default is JsonPlusSerializer.5.6
Side effectA change that a node or tool makes outside the graph state, such as a charge or an email. A checkpoint cannot undo it.5.3
StateThe shared data of one graph run, declared as a schema whose keys the nodes read and write.6.1
State historyThe list of checkpoints of one thread, newest first, from get_state_history(config).6.6
StepOne superstep of the LangGraph loop, in which every node that is ready runs once.How to read this manual
SpanOne timed operation of OpenTelemetry, with a name, attributes, a status, and a parent.9.4
SuperstepOne turn of the LangGraph loop. It plans the tasks that are ready, runs them, and then applies all of their writes at once.2.1
StoreAn object that saves JSON items by namespace and key, shared by all threads of a graph.5.4
Stratified subsetThe 30 bench tasks numbered 01, 04, 07, 10, 13, and 16 in each family, which the models that did not run the full suite ran.The bench method
Stream modeThe name that you pass as stream_mode, which decides what stream yields at each step.5.1
StreamPartThe dict that stream(..., version="v2") yields, with the keys type, ns, and data.5.1
Strict passA bench pass where the answer also came through the submit_answer tool.1.2
Structured output strategyThe way create_agent gets an object of your schema from the model, into structured_response.4.2
SubagentAn agent that another agent calls as a tool. The caller sees only its last message.6.7
SubgraphA compiled graph used as a node of another graph. Shared keys of the two schemas pass between them.6.7
Summary evaluatorA function that scores all the rows of an experiment at once, such as an accuracy.7.7
Summary messageThe human message that SummarizationMiddleware writes in place of old messages.5.5
System promptThe instructions that go first in every model request of an agent.3.5
Target, of an evaluationThe function that evaluate calls with the inputs of each example.7.7
Target, of an MCP adapterThe first argument of MCPAdapter: an http or https URL, a Path, a transport, a server, or a config.7.3
TaskA function decorated with @task. A call returns a future, and LangGraph saves its result when it finishes.6.3
Task suiteThe 99 tasks of the bench kit, in five families, each checked by what its tools changed.1.2
Text splitterAn object that cuts a document into chunks of at most chunk_size characters, with chunk_overlap characters repeated.7.1
ThreadThe series of checkpoints saved under one thread_id. A thread is the conversation.5.2
ToolA function wrapped by @tool, with a name, a description, and a JSON schema for its arguments.3.4
Tool callAn entry in AIMessage.tool_calls with a name, parsed args, and an id.3.3
Tool call idThe id that the model gives each tool call, which the ToolMessage of that call carries back in tool_call_id.3.4
Tool errorA failure while the agent runs a tool call. Its kind decides if the run raises or goes on.3.4
Tool eventA chunk of the tools stream mode: tool-started, tool-output-delta, tool-finished, or tool-error.5.1
ToolRuntimeA parameter type that gives a tool the state, the context, the store, the stream writer, and the id of the current tool call.3.4
TraceA tree of runs for one top-level call, each with a name, a run type, inputs, outputs, an error, and its child runs.7.6
trim_messagesA function in langchain_core.messages that keeps the first or the last messages of a list up to a token budget.5.5
TurnOne human message and everything up to the reply.How to read this manual
Vector store retrieverThe retriever that as_retriever() returns. It runs one search on the store with the search_kwargs you gave it.7.1
Virtual filesystemThe files channel in the state of a deep agent. With the default backend, the file tools never touch the disk.7.4
Wrap hookA middleware hook that takes a request and a handler, and calls the handler to run the model or the tool.4.5

LangChain (Python): langchain, langchain-core, langgraph, deepagents, langsmith 1.5.0 · c2f4036 · 2026-11-11 · Edition 2026.11