@unif/react-native-chat-sdk 0.6.1 → 1.0.0

package/lib/typescript/module/hooks/ChatProvider.d.ts

@@ -11,8 +11,9 @@ import type { ChatMessage } from '../types/message';
 import type { RequestParams, SSEOutput } from '../types/provider';
 import type { SuggestionItem } from '../types/sse';
 import type { ChatStorage } from '../stores/storage';
+import type { StoreMessage } from '../stores/chatStore';
 import type { AbstractChatProvider } from '../providers/AbstractChatProvider';
-export interface ChatProviderProps<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
+export interface ChatProviderProps<Message extends StoreMessage = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
     provider: AbstractChatProvider<Message, Input, Output>;
     storage?: ChatStorage;
     models?: ModelInfo[];
@@ -24,9 +25,10 @@ export interface ChatProviderProps<Message = ChatMessage, Input = RequestParams<
     }) => Message;
     children: React.ReactNode;
 }
+/** Context 值类型 — 合并 useXChat + useXConversations + useXModel */
 interface ChatContextValue<Message = ChatMessage> {
     messages: MessageInfo<Message>[];
-    requesting: boolean;
+    isRequesting: boolean;
     suggestions: SuggestionItem[];
     error: string | null;
     onRequest: (input: unknown) => void;
@@ -52,7 +54,12 @@ interface ChatContextValue<Message = ChatMessage> {
     models: ModelInfo[];
     setSelectedModel: (id: string) => void;
 }
-export declare function ChatProvider<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput>(props: ChatProviderProps<Message, Input, Output>): import("react/jsx-runtime").JSX.Element;
+export declare function ChatProvider<Message extends StoreMessage = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput>(props: ChatProviderProps<Message, Input, Output>): import("react/jsx-runtime").JSX.Element;
+/**
+ * 消费 ChatProvider 注入的聊天上下文
+ *
+ * @template Message - 消息类型，默认 ChatMessage
+ */
 export declare function useChatContext<Message = ChatMessage>(): ChatContextValue<Message>;
 export {};
 //# sourceMappingURL=ChatProvider.d.ts.map

package/lib/typescript/module/hooks/ChatProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/hooks/ChatProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/hooks/ChatProvider.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/module/hooks/useXChat.d.ts

@@ -1,8 +1,9 @@
 /**
- * useXChat — 聊天操作 hook
+ * useXChat — 聊天操作 Hook
  *
- * 消费 ChatProvider，输出可渲染的 messages 列表
+ * 支持 isRequesting / parser 消息展开 / defaultMessages 初始消息
  */
+import type { StoreMessage } from '../stores/chatStore';
 import type { AbstractChatProvider } from '../providers/AbstractChatProvider';
 import type { ChatMessage, MessageStatus } from '../types/message';
 import type { RequestParams, SSEOutput } from '../types/provider';
@@ -16,6 +17,10 @@ export interface MessageInfo<Message = ChatMessage> {
 export interface UseXChatConfig<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
     conversationKey: string;
     provider: AbstractChatProvider<Message, Input, Output>;
+    /** 将单条消息解析为多条展示消息 */
+    parser?: (message: Message) => Message[];
+    /** 初始消息（同步数组或异步 Promise） */
+    defaultMessages?: Message[] | (() => Promise<Message[]>);
     requestPlaceholder?: (input: Input) => Message;
     requestFallback?: (input: Input, info: {
         error: Error;
@@ -24,7 +29,8 @@ export interface UseXChatConfig<Message = ChatMessage, Input = RequestParams<Mes
 }
 export interface UseXChatReturn<Message = ChatMessage, Input = RequestParams<Message>> {
     messages: MessageInfo<Message>[];
-    requesting: boolean;
+    /** 是否正在请求 */
+    isRequesting: boolean;
     suggestions: SuggestionItem[];
     error: string | null;
     onRequest: (input: Input) => void;
@@ -35,5 +41,5 @@ export interface UseXChatReturn<Message = ChatMessage, Input = RequestParams<Mes
     setMessage: (id: string, partial: Partial<MessageInfo<Message>> | ((msg: MessageInfo<Message>) => Partial<MessageInfo<Message>>)) => void;
     removeMessage: (id: string) => void;
 }
-export declare function useXChat<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput>(config: UseXChatConfig<Message, Input, Output>): UseXChatReturn<Message, Input>;
+export declare function useXChat<Message extends StoreMessage = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput>(config: UseXChatConfig<Message, Input, Output>): UseXChatReturn<Message, Input>;
 //# sourceMappingURL=useXChat.d.ts.map

package/lib/typescript/module/hooks/useXChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useXChat.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useXChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,WAAW;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc,CAC7B,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS;IAElB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAC/C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAC7B,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;IAE9B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,CACX,QAAQ,EACJ,WAAW,CAAC,OAAO,CAAC,EAAE,GACtB,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,KAC3D,IAAI,CAAC;IACV,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EACH,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAC7B,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,KAC/D,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,wBAAgB,QAAQ,CACtB,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS,EAElB,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAC7C,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CA2OhC"}
+{"version":3,"file":"useXChat.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useXChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,WAAW,CAAC,OAAO,GAAG,WAAW;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc,CAC7B,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS;IAElB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,qBAAqB;IACrB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,EAAE,CAAC;IACzC,4BAA4B;IAC5B,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzD,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAC/C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAC7B,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;IAE9B,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACjC,aAAa;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC7C,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,WAAW,EAAE,CACX,QAAQ,EACJ,WAAW,CAAC,OAAO,CAAC,EAAE,GACtB,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,KAAK,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,KAC3D,IAAI,CAAC;IACV,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EACH,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAC7B,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,KAC/D,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAcD,wBAAgB,QAAQ,CACtB,OAAO,SAAS,YAAY,GAAG,WAAW,EAC1C,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS,EAElB,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAC7C,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAqPhC"}

package/lib/typescript/module/index.d.ts

@@ -4,7 +4,7 @@
  */
 export type { ChatMessage, MessageRole, MessageType, MessageStatus, } from './types/message';
 export type { SSEEventType, SSEEnvelopeBase, SSETextEvent, SSECardDataEvent, SSESuggestionEvent, SSEErrorEvent, SSEDoneEvent, SSEEnvelope, SuggestionItem, } from './types/sse';
-export type { RequestParams, SSEOutput, ProviderCallbacks, } from './types/provider';
+export type { RequestParams, SSEOutput, ProviderCallbacks, TransformMessageInfo, TransformParamsOptions, } from './types/provider';
 export { XStream } from './tools/XStream';
 export type { XStreamConfig, XStreamCallbacks } from './tools/XStream';
 export { XRequest } from './tools/XRequest';
@@ -16,6 +16,7 @@ export type { OpenAIChatProviderConfig } from './providers/OpenAIChatProvider';
 export { DeepSeekChatProvider } from './providers/DeepSeekChatProvider';
 export type { DeepSeekChatProviderConfig } from './providers/DeepSeekChatProvider';
 export type { ChatStorage } from './stores/storage';
+export type { StoreMessage, ChatStoreApi } from './stores/chatStore';
 export { getOrCreateChatStore, deleteChatStore, getChatStoreMessages, } from './stores/chatStore';
 export { useXChat } from './hooks/useXChat';
 export type { UseXChatConfig, UseXChatReturn, MessageInfo, } from './hooks/useXChat';

package/lib/typescript/module/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAGnF,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAGnF,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EACV,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EACV,wBAAwB,EACxB,cAAc,GACf,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/module/providers/AbstractChatProvider.d.ts

@@ -1,11 +1,11 @@
 /**
  * AbstractChatProvider — Provider 抽象基类
  *
- * 3 个抽象方法：transformParams / transformLocalMessage / transformMessage
+ * 定义 transformMessage / transformParams / transformLocalMessage 抽象方法
  */
 import type { XRequest } from '../tools/XRequest';
 import type { ChatMessage } from '../types/message';
-import type { RequestParams, SSEOutput, ProviderCallbacks } from '../types/provider';
+import type { RequestParams, SSEOutput, ProviderCallbacks, TransformMessageInfo, TransformParamsOptions } from '../types/provider';
 export declare abstract class AbstractChatProvider<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
     protected request: XRequest;
     constructor(config: {
@@ -13,9 +13,9 @@ export declare abstract class AbstractChatProvider<Message = ChatMessage, Input
     });
     /**
      * 转换请求参数
-     * 将 useXChat.onRequest() 传入的参数转换为 XRequest 需要的格式
+     * 新签名：接收 options 参数（含 messages 等上下文）
      */
-    abstract transformParams(input: Input): Record<string, unknown>;
+    abstract transformParams(input: Input, options?: TransformParamsOptions<Message>): Record<string, unknown>;
     /**
      * 转换本地消息
      * 将请求参数转换为用户发送的本地 ChatMessage（用于消息列表渲染）
@@ -23,9 +23,9 @@ export declare abstract class AbstractChatProvider<Message = ChatMessage, Input
     abstract transformLocalMessage(input: Input): Message;
     /**
      * 转换响应消息
-     * 将 XRequest 返回的流数据转换为 ChatMessage（用于 assistant 消息渲染）
+     * 新签名：接收 info 对象（含 output + current）
      */
-    abstract transformMessage(output: Output, current?: Message): Message;
+    abstract transformMessage(info: TransformMessageInfo<Message, Output>): Message;
     /**
      * 发起请求（内部调用 XRequest）
      */

package/lib/typescript/module/providers/AbstractChatProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/AbstractChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,8BAAsB,oBAAoB,CACxC,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS;IAElB,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAEhB,MAAM,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE;IAIzC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE/D;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAErD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO;IAErE;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI;IAyBtE;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"AbstractChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/AbstractChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,mBAAmB,CAAC;AAE3B,8BAAsB,oBAAoB,CACxC,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS;IAElB,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC;gBAEhB,MAAM,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAA;KAAE;IAIzC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CACtB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAErD;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CACvB,IAAI,EAAE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1C,OAAO;IAEV;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI;IA0BtE;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/lib/typescript/module/providers/DeepSeekChatProvider.d.ts

@@ -6,7 +6,7 @@
  */
 import { OpenAIChatProvider } from './OpenAIChatProvider';
 import type { ChatMessage } from '../types/message';
-import type { SSEOutput } from '../types/provider';
+import type { SSEOutput, TransformMessageInfo } from '../types/provider';
 export interface DeepSeekChatProviderConfig {
     apiKey?: string;
     model?: string;
@@ -17,7 +17,8 @@ export declare class DeepSeekChatProvider extends OpenAIChatProvider {
     constructor(config: DeepSeekChatProviderConfig);
     /**
      * 覆写 transformMessage，处理 DeepSeek reasoning_content
+     * 新签名：info.output + info.current
      */
-    transformMessage(output: SSEOutput, current?: ChatMessage): ChatMessage;
+    transformMessage(info: TransformMessageInfo<ChatMessage, SSEOutput>): ChatMessage;
 }
 //# sourceMappingURL=DeepSeekChatProvider.d.ts.map

package/lib/typescript/module/providers/DeepSeekChatProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeepSeekChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/DeepSeekChatProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,oBAAqB,SAAQ,kBAAkB;gBAC9C,MAAM,EAAE,0BAA0B;IAS9C;;OAEG;IACM,gBAAgB,CACvB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,WAAW,GACpB,WAAW;CAmEf"}
+{"version":3,"file":"DeepSeekChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/DeepSeekChatProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,oBAAqB,SAAQ,kBAAkB;gBAC9C,MAAM,EAAE,0BAA0B;IAS9C;;;OAGG;IACM,gBAAgB,CACvB,IAAI,EAAE,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,GACjD,WAAW;CAkEf"}

package/lib/typescript/module/providers/OpenAIChatProvider.d.ts

@@ -5,7 +5,7 @@
  */
 import { AbstractChatProvider } from './AbstractChatProvider';
 import type { ChatMessage } from '../types/message';
-import type { RequestParams, SSEOutput } from '../types/provider';
+import type { RequestParams, SSEOutput, TransformMessageInfo } from '../types/provider';
 export interface OpenAIChatProviderConfig {
     baseURL: string;
     apiKey?: string;
@@ -26,8 +26,9 @@ export declare class OpenAIChatProvider extends AbstractChatProvider<ChatMessage
     transformLocalMessage(input: RequestParams<ChatMessage>): ChatMessage;
     /**
      * 将 SSE delta 转为 ChatMessage（累积 content）
+     * 新签名：info.output + info.current
      */
-    transformMessage(output: SSEOutput, current?: ChatMessage): ChatMessage;
+    transformMessage(info: TransformMessageInfo<ChatMessage, SSEOutput>): ChatMessage;
     private createEmptyAssistant;
 }
 //# sourceMappingURL=OpenAIChatProvider.d.ts.map

package/lib/typescript/module/providers/OpenAIChatProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OpenAIChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/OpenAIChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,qBAAa,kBAAmB,SAAQ,oBAAoB,CAC1D,WAAW,EACX,aAAa,CAAC,WAAW,CAAC,EAC1B,SAAS,CACV;IACC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,wBAAwB;IAiB5C;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB3E;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW;IAYrE;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW;IAiCvE,OAAO,CAAC,oBAAoB;CAW7B"}
+{"version":3,"file":"OpenAIChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/OpenAIChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,qBAAa,kBAAmB,SAAQ,oBAAoB,CAC1D,WAAW,EACX,aAAa,CAAC,WAAW,CAAC,EAC1B,SAAS,CACV;IACC,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,wBAAwB;IAiB5C;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB3E;;OAEG;IACH,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,WAAW;IAYrE;;;OAGG;IACH,gBAAgB,CACd,IAAI,EAAE,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,GACjD,WAAW;IAkCd,OAAO,CAAC,oBAAoB;CAW7B"}

package/lib/typescript/module/stores/chatStore.d.ts

@@ -1,30 +1,40 @@
 /**
  * Chat 消息状态管理（Zustand）
- * 内部 store，通过 useXChat hook 封装后对外暴露
+ *
+ * 泛型 store，通过 useXChat hook 封装后对外暴露。
+ * M 约束：必须包含 id 字段用于查找/去重。
  */
-import type { ChatMessage } from '../types/message';
 import type { SuggestionItem } from '../types/sse';
-interface ChatState {
-    messages: ChatMessage[];
-    streamingText: string;
+/** store 中消息的最小约束：必须有 id 用于查找/去重 */
+export interface StoreMessage {
+    id: string;
+}
+interface ChatState<M extends StoreMessage> {
+    messages: M[];
     suggestions: SuggestionItem[];
     isRequesting: boolean;
     error: string | null;
-    addMessage: (message: ChatMessage) => void;
-    updateMessage: (id: string, updater: (msg: ChatMessage) => ChatMessage) => void;
-    upsertMessage: (message: ChatMessage) => void;
-    setMessages: (messages: ChatMessage[] | ((prev: ChatMessage[]) => ChatMessage[])) => void;
-    setMessage: (id: string, partial: Partial<ChatMessage> | ((msg: ChatMessage) => Partial<ChatMessage>)) => void;
+    addMessage: (message: M) => void;
+    updateMessage: (id: string, updater: (msg: M) => M) => void;
+    upsertMessage: (message: M) => void;
+    setMessages: (messages: M[] | ((prev: M[]) => M[])) => void;
+    setMessage: (id: string, partial: Partial<M> | ((msg: M) => Partial<M>)) => void;
     removeMessage: (id: string) => void;
     setSuggestions: (items: SuggestionItem[]) => void;
     setRequesting: (v: boolean) => void;
     setError: (error: string | null) => void;
     resetChat: () => void;
-    loadSession: (messages: ChatMessage[]) => void;
+    loadSession: (messages: M[]) => void;
 }
-export declare function getOrCreateChatStore(key: string): import("zustand").UseBoundStore<import("zustand").StoreApi<ChatState>>;
+/** 创建一个泛型 chat store 实例 */
+export declare function createChatStore<M extends StoreMessage>(): import("zustand").UseBoundStore<import("zustand").StoreApi<ChatState<M>>>;
+/** store 实例类型 */
+export type ChatStoreApi<M extends StoreMessage> = ReturnType<typeof createChatStore<M>>;
+/** 获取或创建指定会话的 store */
+export declare function getOrCreateChatStore<M extends StoreMessage>(key: string): ChatStoreApi<M>;
+/** 删除指定会话的 store */
 export declare function deleteChatStore(key: string): void;
-export declare function getChatStoreMessages(key: string): ChatMessage[] | undefined;
-export declare const createChatStore: () => import("zustand").UseBoundStore<import("zustand").StoreApi<ChatState>>;
+/** 读取指定会话的消息列表 */
+export declare function getChatStoreMessages<M extends StoreMessage>(key: string): M[] | undefined;
 export {};
 //# sourceMappingURL=chatStore.d.ts.map

package/lib/typescript/module/stores/chatStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chatStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/chatStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,UAAU,SAAS;IACjB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC3C,aAAa,EAAE,CACb,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,KACvC,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,CACX,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC,KAC/D,IAAI,CAAC;IACV,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,KACzE,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAClD,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;CAChD;AAKD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,0EAO/C;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,QAE1C;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,6BAE/C;AAED,eAAO,MAAM,eAAe,8EA2EvB,CAAC"}
+{"version":3,"file":"chatStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/chatStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,SAAS,CAAC,CAAC,SAAS,YAAY;IACxC,QAAQ,EAAE,CAAC,EAAE,CAAC;IACd,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IACjC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC5D,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5D,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAC3C,IAAI,CAAC;IACV,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAClD,aAAa,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;CACtC;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,+EAyErD;AAED,iBAAiB;AACjB,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI,UAAU,CAC3D,OAAO,eAAe,CAAC,CAAC,CAAC,CAC1B,CAAC;AAMF,uBAAuB;AACvB,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,YAAY,EACzD,GAAG,EAAE,MAAM,GACV,YAAY,CAAC,CAAC,CAAC,CAOjB;AAED,oBAAoB;AACpB,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,QAE1C;AAED,kBAAkB;AAClB,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,YAAY,EACzD,GAAG,EAAE,MAAM,GACV,CAAC,EAAE,GAAG,SAAS,CAEjB"}

package/lib/typescript/module/types/provider.d.ts

@@ -1,6 +1,7 @@
 /**
  * Provider 协议类型
- * 定义 ChatProvider ↔ useXChat 之间的数据契约
+ *
+ * 定义 ChatProvider 与 useXChat 之间的数据契约
  */
 import type { ChatMessage } from './message';
 import type { SuggestionItem } from './sse';
@@ -20,4 +21,16 @@ export interface ProviderCallbacks<Message = ChatMessage> {
     onError: (error: Error) => void;
     onSuggestion?: (items: SuggestionItem[]) => void;
 }
+/** TransformMessage 接收 info 对象而非位置参数 */
+export interface TransformMessageInfo<Message = ChatMessage, Output = SSEOutput> {
+    /** 当前 SSE 输出块 */
+    output: Output;
+    /** 已累积的消息（首块时为 undefined） */
+    current?: Message;
+}
+/** TransformParams 选项 */
+export interface TransformParamsOptions<Message = ChatMessage> {
+    /** 会话中的全部消息 */
+    messages?: Message[];
+}
 //# sourceMappingURL=provider.d.ts.map

package/lib/typescript/module/types/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,WAAW;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,WAAW;IACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CAClD"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/types/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,WAAW;IAC5C,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,WAAW;IACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CAClD;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB,CACnC,OAAO,GAAG,WAAW,EACrB,MAAM,GAAG,SAAS;IAElB,iBAAiB;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,yBAAyB;AACzB,MAAM,WAAW,sBAAsB,CAAC,OAAO,GAAG,WAAW;IAC3D,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-chat-sdk",
-  "version": "0.6.1",
+  "version": "1.0.0",
   "description": "UNIF React Native Chat SDK — 流式通信、Provider、状态管理",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",

package/src/hooks/ChatProvider.tsx

@@ -8,7 +8,7 @@ import React, { createContext, useContext, useMemo } from 'react';
 import { useXChat } from './useXChat';
 import { useXConversations } from './useXConversations';
 import { useXModel } from './useXModel';
-import type { UseXChatConfig, MessageInfo } from './useXChat';
+import type { UseXChatConfig, UseXChatReturn, MessageInfo } from './useXChat';
 import type {
   UseXConversationsOptions,
   SessionSummary,
@@ -18,10 +18,11 @@ import type { ChatMessage } from '../types/message';
 import type { RequestParams, SSEOutput } from '../types/provider';
 import type { SuggestionItem } from '../types/sse';
 import type { ChatStorage } from '../stores/storage';
+import type { StoreMessage } from '../stores/chatStore';
 import type { AbstractChatProvider } from '../providers/AbstractChatProvider';
 
 export interface ChatProviderProps<
-  Message = ChatMessage,
+  Message extends StoreMessage = ChatMessage,
   Input = RequestParams<Message>,
   Output = SSEOutput,
 > {
@@ -35,10 +36,11 @@ export interface ChatProviderProps<
   children: React.ReactNode;
 }
 
+/** Context 值类型 — 合并 useXChat + useXConversations + useXModel */
 interface ChatContextValue<Message = ChatMessage> {
   // useXChat
   messages: MessageInfo<Message>[];
-  requesting: boolean;
+  isRequesting: boolean;
   suggestions: SuggestionItem[];
   error: string | null;
   onRequest: (input: unknown) => void;
@@ -82,23 +84,31 @@ interface ChatContextValue<Message = ChatMessage> {
   setSelectedModel: (id: string) => void;
 }
 
-const ChatContext = createContext<ChatContextValue | null>(null);
+/**
+ * Context 使用 unknown 作为 Message 泛型的默认值，
+ * 在 ChatProvider 和 useChatContext 中通过泛型参数指定具体类型。
+ */
+const ChatContext = createContext<ChatContextValue<unknown> | null>(null);
+
+/** 内存存储实现，用于未传入 storage 时的默认行为 */
+class MemoryStorage implements ChatStorage {
+  private data = new Map<string, string>();
 
-const memoryStorage: ChatStorage = {
-  _data: new Map<string, string>(),
   async getItem(key: string) {
-    return (this._data as Map<string, string>).get(key) ?? null;
-  },
+    return this.data.get(key) ?? null;
+  }
   async setItem(key: string, value: string) {
-    (this._data as Map<string, string>).set(key, value);
-  },
+    this.data.set(key, value);
+  }
   async removeItem(key: string) {
-    (this._data as Map<string, string>).delete(key);
-  },
-} as ChatStorage & { _data: Map<string, string> };
+    this.data.delete(key);
+  }
+}
+
+const memoryStorage = new MemoryStorage();
 
 export function ChatProvider<
-  Message = ChatMessage,
+  Message extends StoreMessage = ChatMessage,
   Input = RequestParams<Message>,
   Output = SSEOutput,
 >(props: ChatProviderProps<Message, Input, Output>) {
@@ -136,10 +146,11 @@ export function ChatProvider<
     ]
   );
 
-  const chat = useXChat(chatConfig);
+  const chat: UseXChatReturn<Message, Input> = useXChat(chatConfig);
 
   const model = useXModel({ models, defaultModel });
 
+  // 合并三个 hook 的返回值
   const value = useMemo(
     () => ({
       ...chat,
@@ -150,12 +161,17 @@ export function ChatProvider<
   );
 
   return (
-    <ChatContext.Provider value={value as unknown as ChatContextValue}>
+    <ChatContext.Provider value={value as ChatContextValue<unknown>}>
       {children}
     </ChatContext.Provider>
   );
 }
 
+/**
+ * 消费 ChatProvider 注入的聊天上下文
+ *
+ * @template Message - 消息类型，默认 ChatMessage
+ */
 export function useChatContext<
   Message = ChatMessage,
 >(): ChatContextValue<Message> {
@@ -163,5 +179,6 @@ export function useChatContext<
   if (!ctx) {
     throw new Error('useChatContext must be used within a ChatProvider');
   }
-  return ctx as unknown as ChatContextValue<Message>;
+  // Context 存储 unknown，读取时通过泛型窄化为具体类型
+  return ctx as ChatContextValue<Message>;
 }