LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
LangGraph
  • Web
  • Channels
  • Pregel
  • Prebuilt
  • Remote
LangGraph SDK
  • Client
  • Auth
  • React
  • Logging
  • React Ui
  • Server
LangGraph Checkpoint
LangGraph Checkpoint MongoDB
LangGraph Checkpoint Postgres
  • Store
LangGraph Checkpoint Redis
  • Shallow
  • Store
LangGraph Checkpoint SQLite
LangGraph Checkpoint Validation
  • Cli
LangGraph API
LangGraph CLI
LangGraph CUA
  • Utils
LangGraph Supervisor
LangGraph Swarm
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

LangGraph
WebChannelsPregelPrebuiltRemote
LangGraph SDK
ClientAuthReactLoggingReact UiServer
LangGraph Checkpoint
LangGraph Checkpoint MongoDB
LangGraph Checkpoint Postgres
Store
LangGraph Checkpoint Redis
ShallowStore
LangGraph Checkpoint SQLite
LangGraph Checkpoint Validation
Cli
LangGraph API
LangGraph CLI
LangGraph CUA
Utils
LangGraph Supervisor
LangGraph Swarm
Language
Theme
JavaScript@langchain/langgraph-sdkindexBaseStream
Interface●Since v1.6

BaseStream

Copy
interface BaseStream

Properties

View source on GitHub

Example

property
assistantId: string
property
branch: string
property
client: Client
property
error: unknown
property
experimental_branchTree: Sequence<StateType>
property
getMessagesMetadata: (message: Message<ToolCall>, index?: number) => MessageMetadata<StateType> | undefined
property
history: ThreadState<StateType>[]
property
interrupt: Interrupt<GetInterruptType<Bag>> | undefined
property
interrupts: Interrupt<GetInterruptType<Bag>>[]
property
isLoading: boolean
property
isThreadLoading: boolean
property
joinStream: (runId: string, lastEventId?: string, options?: __type) => Promise<void>
property
messages: Message<ToolCall>[]
property
setBranch: (branch: string) => void
property
stop: () => Promise<void>
property
submit: (values: GetUpdateType<Bag, StateType> | null | undefined, options?: SubmitOptions<StateType, GetConfigurableType<Bag>>) => Promise<void>
property
values: StateType

Base stream interface shared by all stream types.

Contains core properties for state management, messaging, and stream control that are common to CompiledStateGraph, ReactAgent, and DeepAgent streams.

This interface provides the foundation that all stream types build upon:

  • State management (values, isLoading, error)
  • Message handling (messages)
  • Interrupt handling (interrupt)
  • Stream lifecycle (submit, stop)
  • Branching and history (branch, history)

The ID of the assistant to use.

The current branch of the thread. Used for navigating between different conversation branches.

LangGraph SDK client used to send requests and receive responses.

Last seen error from the stream, if any. Reset to undefined when a new stream starts.

Tree of all branches for the thread. This API is experimental and subject to change.

Get the metadata for a message, such as first thread state the message was seen in and branch information.

Flattened history of thread states of a thread. Contains all states in the current branch's history.

Current interrupt, if the stream is interrupted. Convenience alias for interrupts[0]. For workflows with multiple concurrent interrupts, use interrupts instead.

All current interrupts from the stream. When using Send() fan-out with per-task interrupt() calls, multiple interrupts may be pending simultaneously.

Whether the stream is currently running. true while streaming, false when idle or completed.

Whether the thread is currently being loaded. true during initial thread data fetch.

Join an active stream that's already running.

Messages accumulated during the stream. Includes both human and AI messages. AI messages include typed tool calls based on the agent's tools.

Set the branch of the thread.

Stops the currently running stream.

Create and stream a run to the thread.

The current state values of the stream. Updated as streaming events are received.

Copy
// BaseStream is not used directly - use one of the specialized interfaces:
// - UseGraphStream for CompiledStateGraph
// - UseAgentStream for ReactAgent (createAgent)
// - UseDeepAgentStream for DeepAgent (createDeepAgent)