@langgraph-js/sdk 4.3.3 → 4.3.5

package/dist/History.d.ts

@@ -43,7 +43,7 @@ export declare class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    activateSession(sessionId: string): Promise<SessionInfo>;
+    activateSession(sessionId: string, mustResetStream?: boolean): Promise<SessionInfo>;
     /**
      * @zh 获取当前活跃的会话
      * @en Gets the current active session

package/dist/History.js

@@ -45,18 +45,18 @@ export class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    async activateSession(sessionId) {
-        const session = this.sessions.get(sessionId);
-        if (!session) {
-            throw new Error(`Session ${sessionId} not found`);
-        }
+    async activateSession(sessionId, mustResetStream = false) {
+        const session = this.sessions.get(sessionId) || {
+            sessionId,
+            agentName: this.virtualClient.getCurrentAssistant()?.graph_id,
+        };
         // 懒加载：只在激活时创建 Client
         if (!session.client) {
             const client = new LangGraphClient(this.clientConfig);
             await client.initAssistant(session.agentName);
             // 只有在有 thread 的情况下才重置（恢复已有会话）
             // 新会话的 thread 会在发送第一条消息时自动创建
-            if (session.thread) {
+            if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }
             session.client = client;

package/dist/LangGraphClient.js

@@ -349,7 +349,6 @@ export class LangGraphClient extends EventEmitter {
         else if (chunk.event === "values") {
             const data = chunk.data;
             if (data?.__interrupt__) {
-                this._status = "interrupted";
                 const humanInTheLoopData = this.getHumanInTheLoopData(data?.__interrupt__);
                 if (humanInTheLoopData) {
                     this.humanInTheLoop = humanInTheLoopData;
@@ -357,9 +356,6 @@ export class LangGraphClient extends EventEmitter {
                 else {
                     this.interruptData = data.__interrupt__;
                 }
-                this.emit("interruptChange", {
-                    event: "interruptChange",
-                });
             }
             else if (data?.messages) {
                 const isResume = !!command?.resume;
@@ -396,9 +392,13 @@ export class LangGraphClient extends EventEmitter {
                 // json 校验
                 return this.callFETool(toolMessage, tool.args);
             });
+            console.log("batch call tools", result.length);
+            // 只有当卡住流程时，才改变状态为 interrupted
             this._status = "interrupted";
             this.currentThread.status = "interrupted"; // 修复某些机制下，状态不为 interrupted 与后端有差异
-            console.log("batch call tools", result.length);
+            this.emit("interruptChange", {
+                event: "interruptChange",
+            });
             return Promise.all(result);
         }
     }

package/dist/react/ChatContext.d.ts

@@ -16,6 +16,7 @@ export declare const useChat: () => UnionStore<{
         currentAgent: import("nanostores").PreinitializedWritableAtom<string> & object;
         currentChatId: import("nanostores").PreinitializedWritableAtom<string | null> & object;
         currentNodeName: import("nanostores").PreinitializedWritableAtom<string> & object;
+        currentStatus: import("nanostores").PreinitializedWritableAtom<string> & object;
         interruptData: import("nanostores").PreinitializedWritableAtom<import("../humanInTheLoop.js").InterruptData | null> & object;
         isInterrupted: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         tools: import("nanostores").PreinitializedWritableAtom<import("../index.js").UnionTool<any, Object, any>[]> & object;
@@ -33,7 +34,7 @@ export declare const useChat: () => UnionStore<{
         initClient: () => Promise<import("../History.js").History>;
         getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
         getHistory: () => import("../History.js").History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;

package/dist/solid/ChatContext.d.ts

@@ -16,6 +16,7 @@ export declare const useChat: () => UnionStoreSolid<{
         currentAgent: PreinitializedWritableAtom<string> & object;
         currentChatId: PreinitializedWritableAtom<string | null> & object;
         currentNodeName: PreinitializedWritableAtom<string> & object;
+        currentStatus: PreinitializedWritableAtom<string> & object;
         interruptData: PreinitializedWritableAtom<import("../humanInTheLoop.js").InterruptData | null> & object;
         isInterrupted: PreinitializedWritableAtom<boolean> & object;
         tools: PreinitializedWritableAtom<import("../index.js").UnionTool<any, Object, any>[]> & object;
@@ -33,7 +34,7 @@ export declare const useChat: () => UnionStoreSolid<{
         initClient: () => Promise<import("../History.js").History>;
         getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
         getHistory: () => import("../History.js").History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;

package/dist/ui-store/createChatStore.d.ts

@@ -32,6 +32,7 @@ export declare const createChatStore: (initClientName: string, config: Partial<L
         currentAgent: import("nanostores").PreinitializedWritableAtom<string> & object;
         currentChatId: import("nanostores").PreinitializedWritableAtom<string | null> & object;
         currentNodeName: import("nanostores").PreinitializedWritableAtom<string> & object;
+        currentStatus: import("nanostores").PreinitializedWritableAtom<string> & object;
         interruptData: import("nanostores").PreinitializedWritableAtom<InterruptData | null> & object;
         isInterrupted: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         tools: import("nanostores").PreinitializedWritableAtom<UnionTool<any, Object, any>[]> & object;
@@ -49,7 +50,7 @@ export declare const createChatStore: (initClientName: string, config: Partial<L
         initClient: () => Promise<History>;
         getClient: () => LangGraphClient<unknown> | null;
         getHistory: () => History | null;
-        activateSession: (sessionId: string) => Promise<void>;
+        activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;

package/dist/ui-store/createChatStore.js

@@ -58,6 +58,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
     const currentAgent = atom(initClientName);
     const currentChatId = atom(null);
     const currentNodeName = atom("__start__");
+    const currentStatus = atom("idle");
     // Interrupt 状态
     const interruptData = atom(null);
     const isInterrupted = atom(false);
@@ -87,6 +88,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         const lastMessage = messages[messages.length - 1];
         currentNodeName.set(lastMessage?.node_name || lastMessage?.name || "__start__");
         renderMessages.set(messages);
+        currentStatus.set(newClient.status);
     }, 10);
     // ============ 工具和图表辅助函数 ============
     const refreshTools = async () => {
@@ -212,6 +214,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
                 isInterrupted.set(false);
             }
             updateUI(newClient);
+            client.set(client.get());
         };
         newClient.on("start", onStart);
         newClient.on("thread", onThread);
@@ -231,7 +234,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         };
     }
     // ============ 会话激活逻辑 ============
-    async function activateSession(sessionId) {
+    async function activateSession(sessionId, mustResetStream = false) {
         const historyManager = history.get();
         if (!historyManager)
             return;
@@ -243,7 +246,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             inChatError.set(null);
             interruptData.set(null);
             isInterrupted.set(false);
-            const session = await historyManager.activateSession(sessionId);
+            const session = await historyManager.activateSession(sessionId, mustResetStream);
             const activeClient = session.client;
             if (activeClient) {
                 cleanupCurrentClient = setupClientListeners(activeClient);
@@ -325,9 +328,8 @@ export const createChatStore = (initClientName, config, context = {}) => {
         const c = client.get();
         if (!c)
             return null;
-        const toolsDefine = c.tools.getAllTools();
-        const tool = toolsDefine.find((i) => i.name === tool_name)?.render;
-        return tool ? (message) => tool(new ToolRenderData(message, c)) : null;
+        const toolRender = c.tools.getTool(tool_name)?.render;
+        return toolRender ? (message) => toolRender(new ToolRenderData(message, c)) : null;
     }
     // ============ 返回 Store API ============
     const artifactHook = useArtifacts(renderMessages, client);
@@ -345,6 +347,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             currentAgent,
             currentChatId,
             currentNodeName,
+            currentStatus,
             // Interrupt 状态
             interruptData,
             isInterrupted,
@@ -413,7 +416,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             // 历史记录（兼容旧 API）
             addToHistory,
             createNewChat: createNewSession,
-            toHistoryChat: (thread) => activateSession(thread.thread_id),
+            toHistoryChat: (thread) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread) {
                 const historyManager = history.get();
                 if (historyManager) {

package/dist/vue/ChatContext.d.ts

@@ -59,6 +59,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             currentAgent: PreinitializedWritableAtom<string> & object;
             currentChatId: PreinitializedWritableAtom<string | null> & object;
             currentNodeName: PreinitializedWritableAtom<string> & object;
+            currentStatus: PreinitializedWritableAtom<string> & object;
             interruptData: PreinitializedWritableAtom<import("../humanInTheLoop.js").InterruptData | null> & object;
             isInterrupted: PreinitializedWritableAtom<boolean> & object;
             tools: PreinitializedWritableAtom<import("../index.js").UnionTool<any, Object, any>[]> & object;
@@ -76,7 +77,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             initClient: () => Promise<import("../History.js").History>;
             getClient: () => import("../LangGraphClient.js").LangGraphClient<unknown> | null;
             getHistory: () => import("../History.js").History | null;
-            activateSession: (sessionId: string) => Promise<void>;
+            activateSession: (sessionId: string, mustResetStream?: boolean) => Promise<void>;
             createNewSession: () => Promise<void>;
             refreshSessionList: () => Promise<void>;
             refreshHistoryList: () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "4.3.3",
+  "version": "4.3.5",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",

package/src/History.ts

@@ -78,11 +78,11 @@ export class History {
      * @zh 激活指定会话（懒加载创建 Client）
      * @en Activates the specified session (lazy load client)
      */
-    async activateSession(sessionId: string): Promise<SessionInfo> {
-        const session = this.sessions.get(sessionId);
-        if (!session) {
-            throw new Error(`Session ${sessionId} not found`);
-        }
+    async activateSession(sessionId: string, mustResetStream = false): Promise<SessionInfo> {
+        const session: SessionInfo = this.sessions.get(sessionId) || {
+            sessionId,
+            agentName: this.virtualClient.getCurrentAssistant()?.graph_id!,
+        };
 
         // 懒加载：只在激活时创建 Client
         if (!session.client) {
@@ -91,7 +91,7 @@ export class History {
 
             // 只有在有 thread 的情况下才重置（恢复已有会话）
             // 新会话的 thread 会在发送第一条消息时自动创建
-            if (session.thread) {
+            if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }
 

package/src/LangGraphClient.ts

@@ -472,16 +472,12 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                   }
                 | undefined;
             if (data?.__interrupt__) {
-                this._status = "interrupted";
                 const humanInTheLoopData = this.getHumanInTheLoopData(data?.__interrupt__);
                 if (humanInTheLoopData) {
                     this.humanInTheLoop = humanInTheLoopData;
                 } else {
                     this.interruptData = data.__interrupt__;
                 }
-                this.emit("interruptChange", {
-                    event: "interruptChange",
-                });
             } else if (data?.messages) {
                 const isResume = !!command?.resume;
                 const isLongerThanLocal = data.messages.length >= this.messageProcessor.getGraphMessages().length;
@@ -516,9 +512,13 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                 // json 校验
                 return this.callFETool(toolMessage, tool.args);
             });
+            console.log("batch call tools", result.length);
+            // 只有当卡住流程时，才改变状态为 interrupted
             this._status = "interrupted";
             this.currentThread!.status = "interrupted"; // 修复某些机制下，状态不为 interrupted 与后端有差异
-            console.log("batch call tools", result.length);
+            this.emit("interruptChange", {
+                event: "interruptChange",
+            });
             return Promise.all(result);
         }
     }

package/src/tool/ToolUI.ts

@@ -50,6 +50,7 @@ export class ToolRenderData<I, D> {
 
         return this.client.doneHumanInTheLoopWaiting(this.message.id!, this.getToolActionRequestID(), response);
     }
+
     get state() {
         if (this.message.type === "tool" && this.message?.additional_kwargs?.done) {
             return "done";

package/src/ui-store/createChatStore.ts

@@ -78,7 +78,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
     const currentAgent = atom<string>(initClientName);
     const currentChatId = atom<string | null>(null);
     const currentNodeName = atom<string>("__start__");
-
+    const currentStatus = atom<string>("idle");
     // Interrupt 状态
     const interruptData = atom<InterruptData | null>(null);
     const isInterrupted = atom<boolean>(false);
@@ -117,6 +117,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
 
         currentNodeName.set(lastMessage?.node_name || lastMessage?.name || "__start__");
         renderMessages.set(messages);
+        currentStatus.set(newClient.status);
     }, 10);
     // ============ 工具和图表辅助函数 ============
 
@@ -256,6 +257,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
                 isInterrupted.set(false);
             }
             updateUI(newClient);
+            client.set(client.get());
         };
 
         newClient.on("start", onStart);
@@ -279,7 +281,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
 
     // ============ 会话激活逻辑 ============
 
-    async function activateSession(sessionId: string) {
+    async function activateSession(sessionId: string, mustResetStream = false) {
         const historyManager = history.get();
         if (!historyManager) return;
 
@@ -293,7 +295,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             interruptData.set(null);
             isInterrupted.set(false);
 
-            const session = await historyManager.activateSession(sessionId);
+            const session = await historyManager.activateSession(sessionId, mustResetStream);
             const activeClient = session.client;
 
             if (activeClient) {
@@ -383,9 +385,8 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
     function getToolUIRender(tool_name: string) {
         const c = client.get();
         if (!c) return null;
-        const toolsDefine = c.tools.getAllTools();
-        const tool = toolsDefine.find((i) => i.name === tool_name!)?.render;
-        return tool ? (message: RenderMessage) => tool(new ToolRenderData(message, c)) : null;
+        const toolRender = c.tools.getTool(tool_name)?.render;
+        return toolRender ? (message: RenderMessage) => toolRender(new ToolRenderData(message, c)) : null;
     }
 
     // ============ 返回 Store API ============
@@ -407,6 +408,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             currentAgent,
             currentChatId,
             currentNodeName,
+            currentStatus,
 
             // Interrupt 状态
             interruptData,
@@ -486,7 +488,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             // 历史记录（兼容旧 API）
             addToHistory,
             createNewChat: createNewSession,
-            toHistoryChat: (thread: Thread<{ messages: Message[] }>) => activateSession(thread.thread_id),
+            toHistoryChat: (thread: Thread<{ messages: Message[] }>) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread: Thread<{ messages: Message[] }>) {
                 const historyManager = history.get();
                 if (historyManager) {

package/dist/server/createState.d.ts

@@ -1,13 +0,0 @@
-import { AnnotationRoot, StateDefinition } from "@langchain/langgraph";
-/**
- * create state for langgraph
- * @example
- * export const GraphState = createState(createReactAgentAnnotation(), ModelState, SwarmState).build({
- *   current_plan: createDefaultAnnotation<Plan | null>(() => null),
- *   title: createDefaultAnnotation<string>(() => ""),
- *});
- */
-export declare const createState: <T extends readonly AnnotationRoot<any>[]>(...parents: T) => {
-    build: <D extends StateDefinition>(state?: D) => any;
-};
-export declare const createDefaultAnnotation: <T>(defaultValue: () => T) => any;

package/dist/server/createState.js

@@ -1,20 +0,0 @@
-import { Annotation } from "@langchain/langgraph";
-/**
- * create state for langgraph
- * @example
- * export const GraphState = createState(createReactAgentAnnotation(), ModelState, SwarmState).build({
- *   current_plan: createDefaultAnnotation<Plan | null>(() => null),
- *   title: createDefaultAnnotation<string>(() => ""),
- *});
- */
-export const createState = (...parents) => {
-    return {
-        build: (state = {}) => {
-            return Annotation.Root(Object.assign({}, ...parents.map((p) => p.spec), state));
-        },
-    };
-};
-export const createDefaultAnnotation = (defaultValue) => Annotation({
-    reducer: (_, a) => a,
-    default: defaultValue,
-});

package/dist/server/feTools.d.ts

@@ -1,16 +0,0 @@
-import { DynamicStructuredTool } from "@langchain/core/tools";
-export declare const FEToolsState: any;
-export interface FEToolParameters {
-    name: string;
-    type: string;
-    description: string;
-    required: boolean;
-}
-export interface FETool {
-    name: string;
-    description: string;
-    parameters: FEToolParameters[];
-}
-export declare const createFETool: (tool: FETool) => FETool;
-export declare const createFeTools: (tools: FETool[]) => DynamicStructuredTool[];
-export declare const actionToTool: (tool: FETool) => DynamicStructuredTool;

package/dist/server/feTools.js

@@ -1,37 +0,0 @@
-import { interrupt } from "@langchain/langgraph";
-import { createDefaultAnnotation } from "./createState.js";
-import { DynamicStructuredTool } from "@langchain/core/tools";
-import { createState } from "./createState.js";
-export const FEToolsState = createState().build({
-    fe_tools: createDefaultAnnotation(() => []),
-});
-export const createFETool = (tool) => {
-    return tool;
-};
-export const createFeTools = (tools) => {
-    return tools
-        .map((tool) => {
-        try {
-            return actionToTool(tool);
-        }
-        catch (e) {
-            console.error(e);
-            return null;
-        }
-    })
-        .filter((tool) => tool !== null);
-};
-export const actionToTool = (tool) => {
-    const callTool = async (args) => {
-        const data = interrupt(JSON.stringify(args));
-        return [data, null];
-    };
-    const schema = tool.parameters;
-    return new DynamicStructuredTool({
-        name: tool.name,
-        description: tool.description || "",
-        schema,
-        func: callTool,
-        responseFormat: "content_and_artifact",
-    });
-};

package/dist/server/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./createState.js";
-export * from "./feTools.js";
-export * from "./tools/index.js";

package/dist/server/index.js

@@ -1,3 +0,0 @@
-export * from "./createState.js";
-export * from "./feTools.js";
-export * from "./tools/index.js";

package/dist/server/interrupt/index.d.ts

@@ -1,23 +0,0 @@
-import { AIMessage, HumanMessage } from "@langchain/core/messages";
-export declare class InterruptModal {
-    private inputParams;
-    constructor(inputParams: {
-        action: "prompt" | string;
-    });
-    rawResponse?: {
-        response: string;
-        request: {
-            message: string;
-            action: "prompt" | string;
-        };
-    };
-    get response(): {
-        answer?: string;
-    };
-    interrupt(message: string): this;
-    isApprove(): string | undefined;
-    isReject(): boolean;
-    toMessages(options?: {
-        AIAskMessage?: boolean;
-    }): (false | HumanMessage | AIMessage | undefined)[];
-}

package/dist/server/interrupt/index.js

@@ -1,36 +0,0 @@
-import { AIMessage, HumanMessage } from "@langchain/core/messages";
-import { interrupt } from "@langchain/langgraph";
-export class InterruptModal {
-    constructor(inputParams) {
-        this.inputParams = inputParams;
-    }
-    get response() {
-        if (!this.rawResponse)
-            throw new Error("rawResponse is undefined");
-        return JSON.parse(this.rawResponse.response);
-    }
-    interrupt(message) {
-        const inputData = Object.assign({ message }, this.inputParams);
-        const input = JSON.stringify(inputData);
-        const response = interrupt(input);
-        this.rawResponse = {
-            request: inputData,
-            response,
-        };
-        return this;
-    }
-    isApprove() {
-        return this.response.answer;
-    }
-    isReject() {
-        return !this.response.answer;
-    }
-    toMessages(options) {
-        if (!this.rawResponse)
-            throw new Error("rawResponse is undefined");
-        return [
-            (options === null || options === void 0 ? void 0 : options.AIAskMessage) && new AIMessage(this.rawResponse.request.message),
-            new HumanMessage(this.response.answer),
-        ].filter(Boolean);
-    }
-}

package/dist/server/swarm/handoff.d.ts

@@ -1,11 +0,0 @@
-import { z } from "zod";
-import { AnnotationRoot, CompiledStateGraph } from "@langchain/langgraph";
-declare const METADATA_KEY_HANDOFF_DESTINATION = "__handoff_destination";
-interface CreateHandoffToolParams {
-    agentName: string;
-    description?: string;
-    updateState?: (state: any) => Record<string, any>;
-}
-declare const createHandoffTool: ({ agentName, description, updateState }: CreateHandoffToolParams) => import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, {}, {}, any>;
-declare const getHandoffDestinations: <AnnotationRootT extends AnnotationRoot<any>>(agent: CompiledStateGraph<AnnotationRootT["State"], AnnotationRootT["Update"], string, AnnotationRootT["spec"], AnnotationRootT["spec"]>, toolNodeName?: string) => string[];
-export { createHandoffTool, getHandoffDestinations, METADATA_KEY_HANDOFF_DESTINATION };

package/dist/server/swarm/handoff.js

@@ -1,84 +0,0 @@
-import { z } from "zod";
-import { ToolMessage } from "@langchain/core/messages";
-import { tool } from "@langchain/core/tools";
-import { Command, getCurrentTaskInput, } from "@langchain/langgraph";
-const WHITESPACE_RE = /\s+/g;
-const METADATA_KEY_HANDOFF_DESTINATION = "__handoff_destination";
-function _normalizeAgentName(agentName) {
-    /**
-     * Normalize an agent name to be used inside the tool name.
-     */
-    return agentName.trim().replace(WHITESPACE_RE, "_").toLowerCase();
-}
-// type guard
-function isDynamicTool(tool) {
-    return "schema" in tool && "name" in tool && "description" in tool && "responseFormat" in tool;
-}
-const createHandoffTool = ({ agentName, description, updateState }) => {
-    /**
-     * Create a tool that can handoff control to the requested agent.
-     *
-     * @param agentName - The name of the agent to handoff control to, i.e.
-     *   the name of the agent node in the multi-agent graph.
-     *   Agent names should be simple, clear and unique, preferably in snake_case,
-     *   although you are only limited to the names accepted by LangGraph
-     *   nodes as well as the tool names accepted by LLM providers
-     *   (the tool name will look like this: `transfer_to_<agent_name>`).
-     * @param description - Optional description for the handoff tool.
-     * @param updateState - Optional function to customize state updates during handoff.
-     */
-    const toolName = `transfer_to_${_normalizeAgentName(agentName)}`;
-    const toolDescription = description || `Ask agent '${agentName}' for help`;
-    const handoffTool = tool(async (_, config) => {
-        /**
-         * Ask another agent for help.
-         */
-        const toolMessage = new ToolMessage({
-            content: `Successfully transferred to ${agentName}`,
-            name: toolName,
-            tool_call_id: config.toolCall.id,
-        });
-        // inject the current agent state
-        const state = getCurrentTaskInput();
-        // Base update object containing essential state updates
-        const baseUpdate = {
-            messages: state.messages.concat(toolMessage),
-            activeAgent: agentName,
-        };
-        // Merge custom updates with base updates if updateState function is provided
-        const finalUpdate = updateState ? { ...baseUpdate, ...updateState(state) } : baseUpdate;
-        return new Command({
-            goto: agentName,
-            graph: Command.PARENT,
-            update: finalUpdate,
-        });
-    }, {
-        name: toolName,
-        schema: z.object({}),
-        description: toolDescription,
-    });
-    handoffTool.metadata = { [METADATA_KEY_HANDOFF_DESTINATION]: agentName };
-    return handoffTool;
-};
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const getHandoffDestinations = (agent, toolNodeName = "tools") => {
-    /**
-     * Get a list of destinations from agent's handoff tools.
-     *
-     * @param agent - The compiled state graph
-     * @param toolNodeName - The name of the tool node in the graph
-     */
-    const { nodes } = agent.getGraph();
-    if (!(toolNodeName in nodes)) {
-        return [];
-    }
-    const toolNode = nodes[toolNodeName].data;
-    if (!toolNode || !("tools" in toolNode) || !toolNode.tools) {
-        return [];
-    }
-    const { tools } = toolNode;
-    return tools
-        .filter((tool) => isDynamicTool(tool) && tool.metadata !== undefined && METADATA_KEY_HANDOFF_DESTINATION in tool.metadata)
-        .map((tool) => tool.metadata[METADATA_KEY_HANDOFF_DESTINATION]);
-};
-export { createHandoffTool, getHandoffDestinations, METADATA_KEY_HANDOFF_DESTINATION };

package/dist/server/swarm/keepState.d.ts

@@ -1,6 +0,0 @@
-import { SwarmState } from "@langchain/langgraph-swarm";
-/**
- * 保留 langgraph-swarm 在 handoff 时丢失的 state
- */
-export declare const keepAllStateInHandOff: (state: typeof SwarmState.State) => any;
-export declare const createHandoffCommand: <T>(name: string, state: T) => any;

package/dist/server/swarm/keepState.js

@@ -1,21 +0,0 @@
-import { Command } from "@langchain/langgraph";
-/**
- * 保留 langgraph-swarm 在 handoff 时丢失的 state
- */
-export const keepAllStateInHandOff = (state) => {
-    // omit activeAgent and messages
-    const { activeAgent, messages, ...rest } = state;
-    return {
-        ...rest,
-    };
-};
-export const createHandoffCommand = (name, state) => {
-    return new Command({
-        goto: name,
-        graph: Command.PARENT,
-        update: {
-            active_agent: name,
-            ...state,
-        },
-    });
-};

package/dist/server/tools/index.d.ts

@@ -1 +0,0 @@
-export * from "./sequential-thinking.js";

package/dist/server/tools/index.js

@@ -1 +0,0 @@
-export * from "./sequential-thinking.js";

package/dist/server/tools/sequential-thinking.d.ts

@@ -1,52 +0,0 @@
-import { z } from "zod";
-export declare const SequentialThinkingTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
-    thought: z.ZodString;
-    nextThoughtNeeded: z.ZodBoolean;
-    thoughtNumber: z.ZodNumber;
-    totalThoughts: z.ZodNumber;
-    isRevision: z.ZodOptional<z.ZodBoolean>;
-    revisesThought: z.ZodOptional<z.ZodNumber>;
-    branchFromThought: z.ZodOptional<z.ZodNumber>;
-    branchId: z.ZodOptional<z.ZodString>;
-    needsMoreThoughts: z.ZodOptional<z.ZodBoolean>;
-}, "strip", z.ZodTypeAny, {
-    thought: string;
-    nextThoughtNeeded: boolean;
-    thoughtNumber: number;
-    totalThoughts: number;
-    isRevision?: boolean | undefined;
-    revisesThought?: number | undefined;
-    branchFromThought?: number | undefined;
-    branchId?: string | undefined;
-    needsMoreThoughts?: boolean | undefined;
-}, {
-    thought: string;
-    nextThoughtNeeded: boolean;
-    thoughtNumber: number;
-    totalThoughts: number;
-    isRevision?: boolean | undefined;
-    revisesThought?: number | undefined;
-    branchFromThought?: number | undefined;
-    branchId?: string | undefined;
-    needsMoreThoughts?: boolean | undefined;
-}>, {
-    thought: string;
-    nextThoughtNeeded: boolean;
-    thoughtNumber: number;
-    totalThoughts: number;
-    isRevision?: boolean | undefined;
-    revisesThought?: number | undefined;
-    branchFromThought?: number | undefined;
-    branchId?: string | undefined;
-    needsMoreThoughts?: boolean | undefined;
-}, {
-    thought: string;
-    nextThoughtNeeded: boolean;
-    thoughtNumber: number;
-    totalThoughts: number;
-    isRevision?: boolean | undefined;
-    revisesThought?: number | undefined;
-    branchFromThought?: number | undefined;
-    branchId?: string | undefined;
-    needsMoreThoughts?: boolean | undefined;
-}, string>;

package/dist/server/tools/sequential-thinking.js

@@ -1,69 +0,0 @@
-import { tool } from "@langchain/core/tools";
-import { z } from "zod";
-const schema = z.object({
-    thought: z.string().describe("Your current thinking step"),
-    nextThoughtNeeded: z.boolean().describe("Whether another thought step is needed"),
-    thoughtNumber: z.number().min(1).describe("Current thought number"),
-    totalThoughts: z.number().min(1).describe("Estimated total thoughts needed"),
-    isRevision: z.boolean().optional().describe("Whether this revises previous thinking"),
-    revisesThought: z.number().min(1).optional().describe("Which thought is being reconsidered"),
-    branchFromThought: z.number().min(1).optional().describe("Branching point thought number"),
-    branchId: z.string().optional().describe("Branch identifier"),
-    needsMoreThoughts: z.boolean().optional().describe("If more thoughts are needed"),
-});
-// 存储思考历史
-const thoughtHistory = [];
-const branches = {};
-export const SequentialThinkingTool = tool(async (args) => {
-    try {
-        if (args.thoughtNumber > args.totalThoughts) {
-            args.totalThoughts = args.thoughtNumber;
-        }
-        thoughtHistory.push(args);
-        if (args.branchFromThought && args.branchId) {
-            if (!branches[args.branchId]) {
-                branches[args.branchId] = [];
-            }
-            branches[args.branchId].push(args);
-        }
-        return JSON.stringify({
-            thoughtNumber: args.thoughtNumber,
-            totalThoughts: args.totalThoughts,
-            nextThoughtNeeded: args.nextThoughtNeeded,
-            branches: Object.keys(branches),
-            thoughtHistoryLength: thoughtHistory.length,
-        }, null, 2);
-    }
-    catch (error) {
-        return JSON.stringify({
-            error: error instanceof Error ? error.message : String(error),
-            status: "failed",
-        }, null, 2);
-    }
-}, {
-    name: "sequential-thinking",
-    description: `A detailed tool for dynamic and reflective problem-solving through thoughts.
-This tool helps analyze problems through a flexible thinking process that can adapt and evolve.
-Each thought can build on, question, or revise previous insights as understanding deepens.
-
-When to use this tool:
-- Breaking down complex problems into steps
-- Planning and design with room for revision
-- Analysis that might need course correction
-- Problems where the full scope might not be clear initially
-- Problems that require a multi-step solution
-- Tasks that need to maintain context over multiple steps
-- Situations where irrelevant information needs to be filtered out
-
-Key features:
-- You can adjust total_thoughts up or down as you progress
-- You can question or revise previous thoughts
-- You can add more thoughts even after reaching what seemed like the end
-- You can express uncertainty and explore alternative approaches
-- Not every thought needs to build linearly - you can branch or backtrack
-- Generates a solution hypothesis
-- Verifies the hypothesis based on the Chain of Thought steps
-- Repeats the process until satisfied
-- Provides a correct answer`,
-    schema,
-});

package/dist/server/utils.d.ts

@@ -1,3 +0,0 @@
-import { BaseMessage, HumanMessage } from "@langchain/core/messages";
-export declare const getTextMessageContent: (message: BaseMessage) => string;
-export declare function getLastHumanMessage(messages: BaseMessage[]): HumanMessage | undefined;

package/dist/server/utils.js

@@ -1,24 +0,0 @@
-import { isHumanMessage } from "@langchain/core/messages";
-export const getTextMessageContent = (message) => {
-    if (typeof message.content === "string") {
-        return message.content;
-    }
-    else {
-        return message.content
-            .filter((i) => i.type === "text")
-            .map((i) => i.text)
-            .join("\n");
-    }
-};
-export function getLastHumanMessage(messages) {
-    // 从后往前遍历消息列表
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const message = messages[i];
-        // 检查消息是否是 HumanMessage 的实例
-        if (isHumanMessage(message)) {
-            return message;
-        }
-    }
-    // 如果没有找到 HumanMessage，则返回 undefined
-    return undefined;
-}

package/dist/test-type.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/test-type.js

@@ -1,5 +0,0 @@
-const t = {
-    type: "tool",
-    tool_call_id: "123"
-};
-export {};

package/dist/types.d.ts

@@ -1,106 +0,0 @@
-import { Thread, Assistant, Run, StreamMode, Command, Metadata, AssistantGraph, OnConflictBehavior, ThreadStatus, ValuesStreamEvent, UpdatesStreamEvent, DebugStreamEvent, MessagesStreamEvent, MessagesTupleStreamEvent, CustomStreamEvent, EventsStreamEvent, ErrorStreamEvent, MetadataStreamEvent, FeedbackStreamEvent, Config, Checkpoint } from "@langchain/langgraph-sdk";
-import { StreamEvent } from "@langchain/core/tracers/log_stream";
-export type AssistantSortBy = "assistant_id" | "graph_id" | "name" | "created_at" | "updated_at";
-export type ThreadSortBy = "thread_id" | "status" | "created_at" | "updated_at";
-export type SortOrder = "asc" | "desc";
-export type RunStatus = "pending" | "running" | "error" | "success" | "timeout" | "interrupted";
-export type MultitaskStrategy = "reject" | "interrupt" | "rollback" | "enqueue";
-export type DisconnectMode = "cancel" | "continue";
-export type OnCompletionBehavior = "complete" | "continue";
-export type CancelAction = "interrupt" | "rollback";
-export type TypedAsyncGenerator<TStateType = unknown, TUpdateType = TStateType, TCustomType = unknown> = AsyncGenerator<{
-    values: ValuesStreamEvent<TStateType>;
-    updates: UpdatesStreamEvent<TUpdateType>;
-    custom: CustomStreamEvent<TCustomType>;
-    debug: DebugStreamEvent;
-    messages: MessagesStreamEvent;
-    "messages-tuple": MessagesTupleStreamEvent;
-    events: EventsStreamEvent;
-}[StreamMode] | ErrorStreamEvent | MetadataStreamEvent | FeedbackStreamEvent>;
-/**
- * 兼容 LangGraph SDK 的接口定义，方便进行无侵入式的扩展
- */
-export interface ILangGraphClient<TStateType = {}, TUpdateType = TStateType> {
-    assistants: {
-        search(query?: {
-            graphId?: string;
-            metadata?: Metadata;
-            limit?: number;
-            offset?: number;
-            sortBy?: AssistantSortBy;
-            sortOrder?: SortOrder;
-        }): Promise<Assistant[]>;
-        getGraph(assistantId: string, options?: {
-            xray?: boolean | number;
-        }): Promise<AssistantGraph>;
-    };
-    threads: {
-        create(payload?: {
-            metadata?: Metadata;
-            threadId?: string;
-            ifExists?: OnConflictBehavior;
-            graphId?: string;
-            supersteps?: Array<{
-                updates: Array<{
-                    values: unknown;
-                    command?: Command;
-                    asNode: string;
-                }>;
-            }>;
-        }): Promise<Thread<TStateType>>;
-        search(query?: {
-            metadata?: Metadata;
-            limit?: number;
-            offset?: number;
-            status?: ThreadStatus;
-            sortBy?: ThreadSortBy;
-            sortOrder?: SortOrder;
-        }): Promise<Thread<TStateType>[]>;
-        get(threadId: string): Promise<Thread<TStateType>>;
-        delete(threadId: string): Promise<void>;
-    };
-    runs: {
-        list(threadId: string, options?: {
-            limit?: number;
-            offset?: number;
-            status?: RunStatus;
-        }): Promise<Run[]>;
-        stream<TSubgraphs extends boolean = false>(threadId: string, assistantId: string, payload?: {
-            input?: Record<string, unknown> | null;
-            metadata?: Metadata;
-            config?: Config;
-            checkpointId?: string;
-            checkpoint?: Omit<Checkpoint, "thread_id">;
-            checkpointDuring?: boolean;
-            interruptBefore?: "*" | string[];
-            interruptAfter?: "*" | string[];
-            multitaskStrategy?: MultitaskStrategy;
-            onCompletion?: OnCompletionBehavior;
-            signal?: AbortController["signal"];
-            webhook?: string;
-            onDisconnect?: DisconnectMode;
-            afterSeconds?: number;
-            ifNotExists?: "create" | "reject";
-            command?: Command;
-            onRunCreated?: (params: {
-                run_id: string;
-                thread_id?: string;
-            }) => void;
-            streamMode?: StreamMode[];
-            streamSubgraphs?: TSubgraphs;
-            streamResumable?: boolean;
-            feedbackKeys?: string[];
-        }): TypedAsyncGenerator<TSubgraphs, TStateType, TUpdateType>;
-        joinStream(threadId: string, runId: string, options?: {
-            signal?: AbortSignal;
-            cancelOnDisconnect?: boolean;
-            lastEventId?: string;
-            streamMode?: StreamMode | StreamMode[];
-        } | AbortSignal): AsyncGenerator<{
-            id?: string;
-            event: StreamEvent;
-            data: any;
-        }>;
-        cancel(threadId: string, runId: string, wait?: boolean, action?: CancelAction): Promise<void>;
-    };
-}

package/dist/types.js

@@ -1 +0,0 @@
-export {};

package/dist/ui-store/rafDebounce.d.ts

@@ -1,6 +0,0 @@
-/**
- * Creates a debounced function that executes once per animation frame
- * @param callback - The function to debounce
- * @returns A function that executes the callback on the next animation frame
- */
-export declare function rafDebounce<T extends (...args: any[]) => any>(callback: T): (...args: Parameters<T>) => void;

package/dist/ui-store/rafDebounce.js

@@ -1,26 +0,0 @@
-/**
- * Creates a debounced function that executes once per animation frame
- * @param callback - The function to debounce
- * @returns A function that executes the callback on the next animation frame
- */
-export function rafDebounce(callback) {
-    let rafId = null;
-    let lastArgs = null;
-    // Return the debounced function
-    return function (...args) {
-        // Store the most recent arguments
-        lastArgs = args;
-        // Cancel any pending animation frame
-        if (rafId !== null) {
-            cancelAnimationFrame(rafId);
-        }
-        // Schedule execution on the next animation frame
-        rafId = requestAnimationFrame(() => {
-            if (lastArgs !== null) {
-                callback(...lastArgs);
-                lastArgs = null;
-            }
-            rafId = null;
-        });
-    };
-}