@langgraph-js/sdk 3.7.1 → 3.8.1

package/dist/tool/createTool.d.ts

@@ -22,6 +22,9 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     isPureParams?: boolean;
 }
 export type ToolCallback<Args extends ZodRawShape> = (args: z.infer<z.ZodObject<Args>>, context?: any) => CallToolResult | Promise<CallToolResult>;
+/**
+ * HumanInTheLoop 的标准回复格式
+ */
 export type InterruptResponse = {
     decisions: ({
         type: "approve";
@@ -33,7 +36,7 @@ export type InterruptResponse = {
         };
     } | {
         type: "reject";
-        message: string;
+        message?: string;
     })[];
 };
 export type CallToolResult = string | {
@@ -170,10 +173,10 @@ export declare const createMCPTool: <Args extends ZodRawShape>(tool: UnionTool<A
     }[];
     isError?: undefined;
 } | {
-    content: {
+    content: InterruptResponse | {
         type: "text";
         text: string;
-    }[] | InterruptResponse | undefined;
+    }[] | undefined;
     isError?: undefined;
 } | {
     content: {

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

@@ -2,109 +2,76 @@ import { LangGraphClient, LangGraphClientConfig, RenderMessage, SendMessageOptio
 import { AssistantGraph, Message, Thread } from "@langchain/langgraph-sdk";
 import { UnionTool } from "../tool/createTool.js";
 import { RevertChatToOptions } from "../time-travel/index.js";
-/**
- * @zh 格式化日期对象为时间字符串。
- * @en Formats a Date object into a time string.
- */
+import { History, SessionInfo } from "../History.js";
 export declare const formatTime: (date: Date) => string;
-/**
- * @zh 格式化数字为带千位分隔符的字符串。
- * @en Formats a number into a string with thousand separators.
- */
 export declare const formatTokens: (tokens: number) => string;
-/**
- * @zh 获取消息内容的文本表示，处理不同类型的消息内容。
- * @en Gets the text representation of message content, handling different types of message content.
- */
 export declare const getMessageContent: (content: any) => string;
-/**
- * @zh 获取历史记录中 Thread 内容的文本表示。
- * @en Gets the text representation of Thread content in history.
- */
 export declare const getHistoryContent: (thread: Thread) => string | any[];
-/**
- * @zh 创建一个用于聊天界面的状态管理器 (store)。
- * @en Creates a state manager (store) for the chat interface.
- */
-export declare const createChatStore: (initClientName: string, config: Partial<LangGraphClientConfig>, context?: {
+interface ChatStoreContext {
     showHistory?: boolean;
     showGraph?: boolean;
     fallbackToAvailableAssistants?: boolean;
     onInit?: (client: LangGraphClient) => void;
-}) => {
+    /** 初始化时是否自动激活最近的历史会话（默认 false，创建新会话） */
+    autoRestoreLastSession?: boolean;
+}
+export declare const createChatStore: (initClientName: string, config: Partial<LangGraphClientConfig>, context?: ChatStoreContext) => {
     data: {
         artifacts: import("nanostores").PreinitializedWritableAtom<import("../artifacts/index.js").ComposedArtifact[]> & object;
         currentArtifactId: import("nanostores").PreinitializedWritableAtom<[string, string] | null> & object;
         showArtifact: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         client: import("nanostores").PreinitializedWritableAtom<LangGraphClient<unknown> | null> & object;
+        history: import("nanostores").PreinitializedWritableAtom<History | null> & object;
+        sessions: import("nanostores").PreinitializedWritableAtom<SessionInfo[]> & object;
         renderMessages: import("nanostores").PreinitializedWritableAtom<RenderMessage[]> & object;
         userInput: import("nanostores").PreinitializedWritableAtom<string> & object;
         loading: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         inChatError: import("nanostores").PreinitializedWritableAtom<string | null> & object;
         currentAgent: import("nanostores").PreinitializedWritableAtom<string> & object;
+        currentChatId: import("nanostores").PreinitializedWritableAtom<string | null> & object;
+        currentNodeName: import("nanostores").PreinitializedWritableAtom<string> & object;
+        tools: import("nanostores").PreinitializedWritableAtom<UnionTool<any, Object, any>[]> & object;
         collapsedTools: import("nanostores").PreinitializedWritableAtom<string[]> & object;
+        showGraph: import("nanostores").PreinitializedWritableAtom<boolean> & object;
+        graphVisualize: import("nanostores").PreinitializedWritableAtom<AssistantGraph | null> & object;
         showHistory: import("nanostores").PreinitializedWritableAtom<boolean> & object;
         historyList: import("nanostores").PreinitializedWritableAtom<Thread<{
             messages: Message[];
         }>[]> & object;
-        currentChatId: import("nanostores").PreinitializedWritableAtom<string | null> & object;
-        showGraph: import("nanostores").PreinitializedWritableAtom<boolean> & object;
-        graphVisualize: import("nanostores").PreinitializedWritableAtom<AssistantGraph | null> & object;
-        currentNodeName: import("nanostores").PreinitializedWritableAtom<string> & object;
-        tools: import("nanostores").PreinitializedWritableAtom<UnionTool<any, Object, any>[]> & object;
     };
     mutations: {
         setCurrentArtifactById: (id: string, tool_id: string) => void;
         setShowArtifact: (show: boolean) => void;
-        refreshTools: () => Promise<void>;
-        setTools(new_tools: UnionTool<any>[]): void;
-        isFELocking(): boolean | undefined;
-        getClient(): LangGraphClient<unknown> | null;
-        initClient: () => Promise<LangGraphClient<unknown>>;
+        initClient: () => Promise<History>;
+        getClient: () => LangGraphClient<unknown> | null;
+        getHistory: () => History | null;
+        activateSession: (sessionId: string) => Promise<void>;
+        createNewSession: () => Promise<void>;
+        refreshSessionList: () => Promise<void>;
+        refreshHistoryList: () => Promise<void>;
         sendMessage: (message?: Message[], extraData?: SendMessageOptions, withoutCheck?: boolean) => Promise<void>;
         stopGeneration: () => void;
+        setUserInput: (input: string) => void;
+        revertChatTo(messageId: string, resend?: boolean, sendOptions?: SendMessageOptions & RevertChatToOptions): Promise<void>;
+        refreshTools: () => Promise<void>;
+        setTools(new_tools: UnionTool<any>[]): void;
         toggleToolCollapse: (toolId: string) => void;
+        getToolUIRender: (tool_name: string) => ((message: RenderMessage) => Object) | null;
+        isFELocking: () => boolean | undefined;
         toggleHistoryVisible: () => void;
-        refreshHistoryList: () => Promise<void>;
+        toggleGraphVisible(): void;
+        refreshGraph: () => Promise<void>;
+        setCurrentAgent(agent: string): Promise<History>;
         addToHistory: (thread: Thread<{
             messages: Message[];
         }>) => void;
-        /**
-         * @zh 回滚到指定的消息。
-         * @en Reverts to the specified message.
-         */
-        revertChatTo(messageId: string, resend?: boolean, sendOptions?: SendMessageOptions & RevertChatToOptions): Promise<void>;
-        /**
-         * @zh 设置用户输入内容。
-         * @en Sets the user input content.
-         */
-        setUserInput(input: string): void;
-        /**
-         * @zh 设置当前的 Agent 并重新初始化客户端。
-         * @en Sets the current Agent and reinitializes the client.
-         */
-        setCurrentAgent(agent: string): Promise<void>;
-        toggleGraphVisible(): void;
-        refreshGraph: () => Promise<void>;
-        /**
-         * @zh 创建一个新的聊天会话。
-         * @en Creates a new chat session.
-         */
-        createNewChat(): void;
-        /**
-         * @zh 切换到指定的历史聊天会话。
-         * @en Switches to the specified historical chat session.
-         */
-        toHistoryChat(thread: Thread<{
+        createNewChat: () => Promise<void>;
+        toHistoryChat: (thread: Thread<{
             messages: Message[];
-        }>): Promise<Thread<unknown> | undefined>;
-        /**
-         * @zh 删除指定的历史聊天会话。
-         * @en Deletes the specified historical chat session.
-         */
+        }>) => Promise<void>;
         deleteHistoryChat(thread: Thread<{
             messages: Message[];
         }>): Promise<void>;
-        getToolUIRender: (tool_name: string) => ((message: RenderMessage) => Object) | null;
     };
 };
+export {};