LangGraph.js SDK 1.12.0：useStream enqueue 可改走服务端持久队列，刷新/多会话可见并可 server cancel

核心背景与行业痛点

Agent 聊天 UI 常用 useStream 把用户连点的任务排进 "enqueue" 队列，但队列若只活在浏览器内存里：一刷新就丢、多标签不同步、关页无法协作取消。云端 LangGraph 部署其实已有 Runs REST，前端却仍把排队当本地玩具——长任务与「人在回路」场景会反复出现幽灵队列与重复提交。

架构亮点与底层机制

[@langchain/[email protected]](https://github.com/langchain-ai/langgraphjs/releases/tag/%40langchain%2Flanggraph-sdk%401.12.0)（#2848）让 "enqueue" 可设 queue: "server"：排队项变成后端真实 run，经 POST/GET /threads/{thread_id}/runs 持久化，并用 POST /threads/{thread_id}/runs/{run_id}/cancel 取消。刷新后仍在，其他会话可见；cancelQueued/clearQueue 同步打到服务端。默认 queue: "local" 保持旧行为。@langchain/[email protected]、[email protected]、[email protected] 同步放出；@langchain/[email protected] 主要是依赖对齐。自定义 AgentServerAdapter 传输不支持该选项——queue 只作用于内置 transport。

权威 Benchmark 与实测跑分对比

发行说明未给队列吞吐或跨会话一致性的公开数字。验收应用两个浏览器会话：server 队列在刷新后仍列出；cancel 后两端消失；未实现 Runs REST 的后端应明确失败而非静默回落 local。不要用 local 队列的内存延迟外推 server 路径。

开发者实战落地与开箱指南

``bash npm i @langchain/[email protected] @langchain/[email protected] ` 在 useStream 上传入 queue: "server"（配合 multitask: "enqueue"），并确认 apiUrl 后端实现 Runs REST。Howto：useStream React；总览见 LangGraph.js 与 npm [@langchain/langgraph-sdk](https://www.npmjs.com/package/@langchain/langgraph-sdk)、@langchain/react`。先在 staging 用两个浏览器会话验证队列持久化与 cancel，再打开生产开关。