@unif/react-native-chat-sdk 0.1.1 → 0.1.2

package/lib/typescript/commonjs/types/sse.d.ts

@@ -0,0 +1,63 @@
+/**
+ * SSEEnvelope 协议类型定义
+ */
+export type SSEEventType = 'text' | 'card_data' | 'suggestion' | 'error' | 'done';
+export interface SSEEnvelopeBase {
+    event_id: string;
+    turn_id: string;
+    seq: number;
+    ts: string;
+    session_id: string;
+}
+export interface SSETextEvent extends SSEEnvelopeBase {
+    type: 'text';
+    payload: {
+        content: string;
+    };
+}
+export interface SSECardDataEvent extends SSEEnvelopeBase {
+    type: 'card_data';
+    payload: {
+        cardType: string;
+        payload: CardPayload;
+    };
+}
+export interface SSESuggestionEvent extends SSEEnvelopeBase {
+    type: 'suggestion';
+    payload: {
+        items: SuggestionItem[];
+    };
+}
+export interface SSEErrorEvent extends SSEEnvelopeBase {
+    type: 'error';
+    payload: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        recover_actions?: ActionPayload[];
+    };
+}
+export interface SSEDoneEvent extends SSEEnvelopeBase {
+    type: 'done';
+    payload: {
+        messageId: string;
+        reason: 'ok' | 'abort' | 'error';
+    };
+}
+export type SSEEnvelope = SSETextEvent | SSECardDataEvent | SSESuggestionEvent | SSEErrorEvent | SSEDoneEvent;
+export interface SuggestionItem {
+    id: string;
+    label: string;
+    action?: ActionPayload;
+    mode?: 'action' | 'input_focus';
+}
+export type ActionType = 'confirm_order' | 'select_product' | 'reorder' | 'add_product' | 'clear_draft' | 'push_dealer' | 'new_order' | 'view_detail' | 'add_to_order' | 'browse_products' | 'retry_order';
+export interface ActionPayload {
+    type: ActionType;
+    payload?: Record<string, unknown>;
+}
+export interface CardPayload {
+    data: Record<string, unknown>;
+    actions: string[];
+}
+//# sourceMappingURL=sse.d.ts.map

package/lib/typescript/commonjs/types/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../../src/types/sse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,WAAW,GACX,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,EAAE,CAAC;KACzB,CAAC;CACH;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;KAClC,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,gBAAgB,GAChB,SAAS,GACT,aAAa,GACb,aAAa,GACb,aAAa,GACb,WAAW,GACX,aAAa,GACb,cAAc,GACd,iBAAiB,GACjB,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

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

@@ -0,0 +1,50 @@
+/**
+ * ChatProvider — 全局数据提供 Context
+ *
+ * 可选的全局 Provider 模式（也可直接使用 hooks）
+ */
+import React from 'react';
+import type { MessageInfo } from './useXChat';
+import type { SessionSummary } from './useXConversations';
+import type { ModelInfo } from './useXModel';
+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 { AbstractChatProvider } from '../providers/AbstractChatProvider';
+export interface ChatProviderProps<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
+    provider: AbstractChatProvider<Message, Input, Output>;
+    storage?: ChatStorage;
+    models?: ModelInfo[];
+    defaultModel?: string;
+    generateId?: () => string;
+    requestPlaceholder?: (input: Input) => Message;
+    requestFallback?: (input: Input, info: {
+        error: Error;
+    }) => Message;
+    children: React.ReactNode;
+}
+interface ChatContextValue<Message = ChatMessage> {
+    messages: MessageInfo<Message>[];
+    requesting: boolean;
+    suggestions: SuggestionItem[];
+    error: string | null;
+    onRequest: (input: unknown) => void;
+    abort: () => void;
+    resetChat: () => void;
+    loadSession: (messages: ChatMessage[]) => void;
+    clearError: () => void;
+    sessions: SessionSummary[];
+    activeId: string;
+    switchSession: (id: string) => Promise<Message[]>;
+    newSession: () => void;
+    deleteSession: (id: string) => Promise<void>;
+    archiveSession: (id: string, title: string, messages: Message[]) => Promise<void>;
+    selectedModel: string;
+    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 useChatContext<Message = ChatMessage>(): ChatContextValue<Message>;
+export {};
+//# sourceMappingURL=ChatProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/hooks/ChatProvider.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAA2C,MAAM,OAAO,CAAC;AAIhE,OAAO,KAAK,EAAiB,WAAW,EAAC,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAA2B,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAClF,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,mCAAmC,CAAC;AAE5E,MAAM,WAAW,iBAAiB,CAChC,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS;IAElB,QAAQ,EAAE,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,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,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,gBAAgB,CAAC,OAAO,GAAG,WAAW;IAE9C,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,OAAO,KAAK,IAAI,CAAC;IACpC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,UAAU,EAAE,MAAM,IAAI,CAAC;IAEvB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAElF,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAiBD,wBAAgB,YAAY,CAC1B,OAAO,GAAG,WAAW,EACrB,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,EAC9B,MAAM,GAAG,SAAS,EAClB,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,2CA8CjD;AAED,wBAAgB,cAAc,CAC5B,OAAO,GAAG,WAAW,KAClB,gBAAgB,CAAC,OAAO,CAAC,CAM7B"}

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

@@ -0,0 +1,36 @@
+/**
+ * useXChat — 聊天操作 hook
+ *
+ * 消费 ChatProvider，输出可渲染的 messages 列表
+ */
+import type { AbstractChatProvider } from '../providers/AbstractChatProvider';
+import type { ChatMessage, MessageStatus } from '../types/message';
+import type { RequestParams, SSEOutput } from '../types/provider';
+import type { SuggestionItem } from '../types/sse';
+export interface MessageInfo<Message = ChatMessage> {
+    id: string;
+    message: Message;
+    status: MessageStatus;
+    extra?: Record<string, unknown>;
+}
+export interface UseXChatConfig<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
+    provider: AbstractChatProvider<Message, Input, Output>;
+    requestPlaceholder?: (input: Input) => Message;
+    requestFallback?: (input: Input, info: {
+        error: Error;
+    }) => Message;
+    generateId?: () => string;
+}
+export interface UseXChatReturn<Message = ChatMessage, Input = RequestParams<Message>> {
+    messages: MessageInfo<Message>[];
+    requesting: boolean;
+    suggestions: SuggestionItem[];
+    error: string | null;
+    onRequest: (input: Input) => void;
+    abort: () => void;
+    resetChat: () => void;
+    loadSession: (messages: ChatMessage[]) => void;
+    clearError: () => void;
+}
+export declare function useXChat<Message = 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

@@ -0,0 +1 @@
+{"version":3,"file":"useXChat.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useXChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAC,WAAW,EAAE,aAAa,EAAC,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,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,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,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC/C,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;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,CAsGhC"}

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

@@ -0,0 +1,24 @@
+/**
+ * useXConversations — 会话管理 hook
+ *
+ * 组合 sessionStore + historyStore，管理会话生命周期
+ */
+import type { ChatStorage } from '../stores/storage';
+import type { ChatMessage } from '../types/message';
+export { type SessionSummary } from '../stores/historyStore';
+export interface UseXConversationsOptions {
+    storage: ChatStorage;
+    maxSessions?: number;
+}
+export declare function useXConversations(options: UseXConversationsOptions): {
+    sessions: import("./useXConversations").SessionSummary[];
+    activeId: string;
+    switchSession: (id: string) => Promise<ChatMessage[]>;
+    newSession: () => void;
+    deleteSession: (id: string) => Promise<void>;
+    archiveSession: (id: string, title: string, messages: ChatMessage[]) => Promise<void>;
+    updateSession: (id: string, data: Partial<{
+        title: string;
+    }>) => void;
+};
+//# sourceMappingURL=useXConversations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useXConversations.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useXConversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAC,KAAK,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB;;;wBAqBpD,MAAM,KAAG,OAAO,CAAC,WAAW,EAAE,CAAC;;wBAY/B,MAAM;yBAWN,MAAM,SAAS,MAAM,YAAY,WAAW,EAAE;wBAQpD,MAAM,QAAQ,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;EAmBhD"}

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

@@ -0,0 +1,18 @@
+/**
+ * useXModel — 模型选择 hook
+ */
+export interface ModelInfo {
+    id: string;
+    name: string;
+    desc: string;
+}
+export interface UseXModelOptions {
+    models: ModelInfo[];
+    defaultModel?: string;
+}
+export declare function useXModel(options: UseXModelOptions): {
+    selectedModel: string;
+    models: ModelInfo[];
+    setSelectedModel: (id: string) => void;
+};
+//# sourceMappingURL=useXModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useXModel.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useXModel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB;;;2BAMP,MAAM;EASjD"}

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

@@ -0,0 +1,27 @@
+/**
+ * @unif/react-native-chat-sdk
+ * AI 聊天 SDK — 流式通信、Provider 模式、状态管理
+ */
+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 { XStream } from './tools/XStream';
+export type { XStreamConfig, XStreamCallbacks } from './tools/XStream';
+export { XRequest } from './tools/XRequest';
+export type { XRequestConfig, XRequestCallbacks } from './tools/XRequest';
+export { SSEParser } from './tools/SSEParser';
+export { AbstractChatProvider } from './providers/AbstractChatProvider';
+export { OpenAIChatProvider } from './providers/OpenAIChatProvider';
+export type { OpenAIChatProviderConfig } from './providers/OpenAIChatProvider';
+export { DeepSeekChatProvider } from './providers/DeepSeekChatProvider';
+export type { DeepSeekChatProviderConfig } from './providers/DeepSeekChatProvider';
+export type { ChatStorage } from './stores/storage';
+export { useXChat } from './hooks/useXChat';
+export type { UseXChatConfig, UseXChatReturn, MessageInfo } from './hooks/useXChat';
+export { useXConversations } from './hooks/useXConversations';
+export type { UseXConversationsOptions, SessionSummary } from './hooks/useXConversations';
+export { useXModel } from './hooks/useXModel';
+export type { UseXModelOptions, ModelInfo } from './hooks/useXModel';
+export { ChatProvider, useChatContext } from './hooks/ChatProvider';
+export type { ChatProviderProps } from './hooks/ChatProvider';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAC,aAAa,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,kBAAkB,CAAC;AAExE,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAG5C,OAAO,EAAC,oBAAoB,EAAC,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAC,wBAAwB,EAAC,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAC,oBAAoB,EAAC,MAAM,kCAAkC,CAAC;AACtE,YAAY,EAAC,0BAA0B,EAAC,MAAM,kCAAkC,CAAC;AAGjF,YAAY,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,YAAY,EAAC,cAAc,EAAE,cAAc,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAElF,OAAO,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAC5D,YAAY,EAAC,wBAAwB,EAAE,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAExF,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAC,gBAAgB,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAEnE,OAAO,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAClE,YAAY,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,38 @@
+/**
+ * AbstractChatProvider — Provider 抽象基类
+ *
+ * 3 个抽象方法：transformParams / transformLocalMessage / transformMessage
+ */
+import type { XRequest } from '../tools/XRequest';
+import type { ChatMessage } from '../types/message';
+import type { RequestParams, SSEOutput, ProviderCallbacks } from '../types/provider';
+export declare abstract class AbstractChatProvider<Message = ChatMessage, Input = RequestParams<Message>, Output = SSEOutput> {
+    protected request: XRequest;
+    constructor(config: {
+        request: XRequest;
+    });
+    /**
+     * 转换请求参数
+     * 将 useXChat.onRequest() 传入的参数转换为 XRequest 需要的格式
+     */
+    abstract transformParams(input: Input): Record<string, unknown>;
+    /**
+     * 转换本地消息
+     * 将请求参数转换为用户发送的本地 ChatMessage（用于消息列表渲染）
+     */
+    abstract transformLocalMessage(input: Input): Message;
+    /**
+     * 转换响应消息
+     * 将 XRequest 返回的流数据转换为 ChatMessage（用于 assistant 消息渲染）
+     */
+    abstract transformMessage(output: Output, current?: Message): Message;
+    /**
+     * 发起请求（内部调用 XRequest）
+     */
+    sendMessage(input: Input, callbacks: ProviderCallbacks<Message>): void;
+    /**
+     * 中止请求
+     */
+    abort(): void;
+}
+//# sourceMappingURL=AbstractChatProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/AbstractChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,QAAQ,EAAoB,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAEnF,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"}

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

@@ -0,0 +1,23 @@
+/**
+ * DeepSeekChatProvider — DeepSeek Provider
+ *
+ * 继承 OpenAIChatProvider（DeepSeek API 兼容 OpenAI 格式）
+ * 额外处理 reasoning_content 字段（DeepSeek 的思考过程）→ 映射到 <think> 标签
+ */
+import { OpenAIChatProvider } from './OpenAIChatProvider';
+import type { ChatMessage } from '../types/message';
+import type { SSEOutput } from '../types/provider';
+export interface DeepSeekChatProviderConfig {
+    apiKey?: string;
+    model?: string;
+    getToken?: () => Promise<string | null>;
+    baseURL?: string;
+}
+export declare class DeepSeekChatProvider extends OpenAIChatProvider {
+    constructor(config: DeepSeekChatProviderConfig);
+    /**
+     * 覆写 transformMessage，处理 DeepSeek reasoning_content
+     */
+    transformMessage(output: SSEOutput, current?: ChatMessage): ChatMessage;
+}
+//# sourceMappingURL=DeepSeekChatProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeepSeekChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/DeepSeekChatProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAEjD,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;CAsEf"}

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

@@ -0,0 +1,33 @@
+/**
+ * OpenAIChatProvider — OpenAI 兼容 Provider
+ *
+ * 兼容所有 OpenAI 标准 API（OpenAI、Azure、Moonshot、通义千问兼容模式等）
+ */
+import { AbstractChatProvider } from './AbstractChatProvider';
+import type { ChatMessage } from '../types/message';
+import type { RequestParams, SSEOutput } from '../types/provider';
+export interface OpenAIChatProviderConfig {
+    baseURL: string;
+    apiKey?: string;
+    model?: string;
+    getToken?: () => Promise<string | null>;
+    endpoint?: string;
+}
+export declare class OpenAIChatProvider extends AbstractChatProvider<ChatMessage, RequestParams<ChatMessage>, SSEOutput> {
+    private model;
+    constructor(config: OpenAIChatProviderConfig);
+    /**
+     * 将消息转为 OpenAI messages 格式: [{role, content}]
+     */
+    transformParams(input: RequestParams<ChatMessage>): Record<string, unknown>;
+    /**
+     * 创建本地用户消息
+     */
+    transformLocalMessage(input: RequestParams<ChatMessage>): ChatMessage;
+    /**
+     * 将 SSE delta 转为 ChatMessage（累积 content）
+     */
+    transformMessage(output: SSEOutput, current?: ChatMessage): ChatMessage;
+    private createEmptyAssistant;
+}
+//# sourceMappingURL=OpenAIChatProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OpenAIChatProvider.d.ts","sourceRoot":"","sources":["../../../../src/providers/OpenAIChatProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,oBAAoB,EAAC,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAC,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAC,aAAa,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAEhE,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"}

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

@@ -0,0 +1,24 @@
+/**
+ * Chat 消息状态管理（Zustand）
+ * 内部 store，通过 useXChat hook 封装后对外暴露
+ */
+import type { ChatMessage } from '../types/message';
+import type { SuggestionItem } from '../types/sse';
+interface ChatState {
+    messages: ChatMessage[];
+    streamingText: string;
+    suggestions: SuggestionItem[];
+    isRequesting: boolean;
+    error: string | null;
+    addMessage: (message: ChatMessage) => void;
+    updateMessage: (id: string, updater: (msg: ChatMessage) => ChatMessage) => void;
+    upsertMessage: (message: ChatMessage) => void;
+    setSuggestions: (items: SuggestionItem[]) => void;
+    setRequesting: (v: boolean) => void;
+    setError: (error: string | null) => void;
+    resetChat: () => void;
+    loadSession: (messages: ChatMessage[]) => void;
+}
+export declare const createChatStore: () => import("zustand").UseBoundStore<import("zustand").StoreApi<ChatState>>;
+export {};
+//# sourceMappingURL=chatStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chatStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/chatStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,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,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,WAAW,KAAK,IAAI,CAAC;IAChF,aAAa,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC9C,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;AAED,eAAO,MAAM,eAAe,8EAoDvB,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * 历史会话持久化
+ * 使用 ChatStorage 抽象，不直接依赖 AsyncStorage
+ */
+import type { ChatMessage } from '../types/message';
+import type { ChatStorage } from './storage';
+export interface SessionSummary {
+    id: string;
+    title: string;
+    lastMessage: string;
+    timestamp: number;
+    messageCount: number;
+}
+export interface HistoryStore {
+    sessions: SessionSummary[];
+    archiveSession: (id: string, title: string, messages: ChatMessage[]) => Promise<void>;
+    loadSessionMessages: (id: string) => Promise<ChatMessage[]>;
+    deleteSession: (id: string) => Promise<void>;
+    clearAll: () => Promise<void>;
+}
+export declare function createHistoryStore(storage: ChatStorage): HistoryStore;
+//# sourceMappingURL=historyStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"historyStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/historyStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,WAAW,CAAC;AAK3C,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,EAAE,CACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,EAAE,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAqFrE"}

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

@@ -0,0 +1,11 @@
+/**
+ * 模型选择状态（Zustand）
+ * 内部 store，通过 useXModel hook 封装后对外暴露
+ */
+interface ModelState {
+    selectedModel: string;
+    setSelectedModel: (id: string) => void;
+}
+export declare const createModelStore: (defaultModel: string) => import("zustand").UseBoundStore<import("zustand").StoreApi<ModelState>>;
+export {};
+//# sourceMappingURL=modelStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modelStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/modelStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,UAAU;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,gBAAgB,GAAI,cAAc,MAAM,4EAIhD,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * 会话状态管理（Zustand）
+ * 内部 store，通过 useXConversations hook 封装后对外暴露
+ */
+interface SessionState {
+    sessionId: string;
+    sessionTitle: string;
+    setSessionId: (id: string) => void;
+    setSessionTitle: (title: string) => void;
+}
+export declare const createSessionStore: (generateId: () => string) => import("zustand").UseBoundStore<import("zustand").StoreApi<SessionState>>;
+export {};
+//# sourceMappingURL=sessionStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../../src/stores/sessionStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,MAAM,8EAMtD,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * ChatStorage — 存储抽象接口
+ * 不绑定 AsyncStorage，支持注入任意存储实现
+ */
+export interface ChatStorage {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/stores/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/lib/typescript/module/tools/SSEParser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SSE 解析器
+ * - event_id 幂等去重
+ * - seq 严格排序（乱序缓冲，顺序到达后 flush）
+ * - 每轮对话调用 reset() 重置
+ */
+import type { SSEEnvelope } from '../types/sse';
+export declare class SSEParser {
+    private processedIds;
+    private buffer;
+    private nextSeq;
+    reset(): void;
+    /**
+     * 解析原始 SSE data 字符串，返回按 seq 排序的事件数组
+     * 已处理的 event_id 会被自动跳过（幂等）
+     */
+    process(raw: string): SSEEnvelope[];
+}
+//# sourceMappingURL=SSEParser.d.ts.map

package/lib/typescript/module/tools/SSEParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SSEParser.d.ts","sourceRoot":"","sources":["../../../../src/tools/SSEParser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,OAAO,CAAK;IAEpB,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE;CA2BpC"}

package/lib/typescript/module/tools/XRequest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * XRequest — 面向 LLM 的 HTTP 请求工具
+ *
+ * 组合 XStream + SSEParser 实现完整 SSE 请求链路
+ */
+import type { SSEOutput } from '../types/provider';
+export interface XRequestConfig {
+    baseURL: string;
+    endpoint?: string;
+    model?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    getToken?: () => Promise<string | null>;
+}
+export interface XRequestCallbacks {
+    onStream?: (chunk: SSEOutput) => void;
+    onSuccess?: (message: string) => void;
+    onError?: (error: {
+        type: string;
+        message: string;
+    }) => void;
+    onAbort?: () => void;
+}
+export declare class XRequest {
+    private config;
+    private stream;
+    private parser;
+    constructor(config: XRequestConfig);
+    create(params: Record<string, unknown>, callbacks: XRequestCallbacks): Promise<void>;
+    abort(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=XRequest.d.ts.map

package/lib/typescript/module/tools/XRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRequest.d.ts","sourceRoot":"","sources":["../../../../src/tools/XRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAGjD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,cAAc;IAI5B,MAAM,CACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA0DhB,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;CAGhB"}

package/lib/typescript/module/tools/XStream.d.ts

@@ -0,0 +1,34 @@
+/**
+ * XStream — SSE 流适配器（React Native 版本）
+ *
+ * 基于 react-native-sse 封装，支持 POST 方法 + 自定义请求体
+ */
+import type { SSEOutput } from '../types/provider';
+export interface XStreamConfig {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+    timeout?: number;
+    transformStream?: (event: {
+        data: string;
+        event?: string;
+    }) => SSEOutput;
+}
+export interface XStreamCallbacks {
+    onMessage: (data: SSEOutput) => void;
+    onError?: (error: Error) => void;
+    onComplete?: () => void;
+    onOpen?: () => void;
+}
+export declare class XStream {
+    private config;
+    private es;
+    private timeoutTimer;
+    constructor(config: XStreamConfig);
+    connect(callbacks: XStreamCallbacks): void;
+    abort(): void;
+    dispose(): void;
+    private clearTimer;
+}
+//# sourceMappingURL=XStream.d.ts.map

package/lib/typescript/module/tools/XStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XStream.d.ts","sourceRoot":"","sources":["../../../../src/tools/XStream.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;CAC1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAUD,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,YAAY,CAA8C;gBAEtD,MAAM,EAAE,aAAa;IAIjC,OAAO,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAmD1C,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,UAAU;CAMnB"}

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

@@ -0,0 +1,22 @@
+/**
+ * Chat 消息类型定义
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+export type MessageType = 'text' | 'card' | 'system';
+export type MessageStatus = 'local' | 'loading' | 'updating' | 'success' | 'error' | 'abort';
+export interface ChatMessage {
+    id: string;
+    text: string;
+    role: MessageRole;
+    createdAt: Date;
+    messageType: MessageType;
+    status: MessageStatus;
+    cardType?: string;
+    cardData?: {
+        data: Record<string, unknown>;
+        actions: string[];
+    };
+    turnId: string;
+    extra?: Record<string, unknown>;
+}
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../src/types/message.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AACrD,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,GACT,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Provider 协议类型
+ * 定义 ChatProvider ↔ useXChat 之间的数据契约
+ */
+import type { ChatMessage } from './message';
+import type { SuggestionItem } from './sse';
+export interface RequestParams<T = ChatMessage> {
+    message: T;
+    messages?: T[];
+    model?: string;
+    extra?: Record<string, unknown>;
+}
+export interface SSEOutput {
+    data: string;
+    event?: string;
+}
+export interface ProviderCallbacks<Message = ChatMessage> {
+    onUpdate: (message: Message) => void;
+    onSuccess: (message: Message) => void;
+    onError: (error: Error) => void;
+    onSuggestion?: (items: SuggestionItem[]) => void;
+}
+//# sourceMappingURL=provider.d.ts.map