@xinghunm/ai-chat 1.4.4 → 1.6.0

package/dist/index.d.mts

@@ -69,6 +69,21 @@ interface ChatHistorySessionListHandlers {
     onSelectHistorySession?: (session: ChatSession) => Promise<ChatHistorySessionMessagesPage | ChatMessage[] | void> | ChatHistorySessionMessagesPage | ChatMessage[] | void;
     onLoadMoreHistoryMessages?: (args: ChatHistorySessionMessageLoadArgs) => Promise<ChatHistorySessionMessagesPage | void> | ChatHistorySessionMessagesPage | void;
 }
+/**
+ * Arguments passed to custom history session action renderers.
+ */
+interface ChatSessionItemActionRenderProps {
+    session: ChatSession;
+    isActive: boolean;
+    isStreaming: boolean;
+    selectSession: () => Promise<void>;
+    startNewChat: () => void;
+    stopSession: () => Promise<void>;
+}
+/**
+ * Optional renderer used to append custom actions to a history session item.
+ */
+type ChatSessionItemActionsRenderer = (args: ChatSessionItemActionRenderProps) => ReactNode;
 /**
  * Client-side image attachment metadata kept in chat messages.
  */
@@ -144,7 +159,7 @@ interface PlanBooleanQuestion extends PlanQuestionBase {
  * Supported question variants in a plan questionnaire.
  */
 type PlanQuestion = PlanSingleSelectQuestion | PlanMultiSelectQuestion | PlanTextQuestion | PlanNumberQuestion | PlanBooleanQuestion;
-type PlanQuestionnaireStatus = 'expired' | 'failed';
+type PlanQuestionnaireStatus = 'expired' | 'failed' | 'submitted';
 /**
  * Merge behavior applied when a keyed structured block is patched repeatedly.
  */
@@ -177,6 +192,10 @@ interface PlanQuestionnaire {
     answers?: Partial<Record<string, PlanQuestionnaireAnswerValue>>;
     status?: PlanQuestionnaireStatus;
     statusMessage?: string;
+    /**
+     * Timeout in seconds for the questionnaire interaction.
+     */
+    timeoutSec?: number;
 }
 interface PlanQuestionSubmissionDetail {
     questionId: string;
@@ -478,6 +497,7 @@ interface AiChatLabels {
     questionnaireMultiSelectHint?: string;
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
+    questionnaireExpired?: string;
     modelLoading?: string;
     modelLoadFailed?: string;
     modelUnavailable?: string;
@@ -487,6 +507,8 @@ interface AiChatLabels {
     sessionHistoryLoading?: string;
     sessionHistoryLoadFailed?: string;
     sessionHistoryEmpty?: string;
+    questionnaireTitle?: string;
+    questionnaireConfirmInTime?: string;
 }
 /**
  * State and actions exposed to custom new-chat trigger renderers.
@@ -499,6 +521,13 @@ interface NewChatTriggerRenderProps {
     stopActiveSession: () => Promise<void>;
     startNewChat: () => Promise<void>;
 }
+/**
+ * State exposed to optional composer mode accessory renderers.
+ */
+interface ChatComposerModeAccessoryRenderProps {
+    selectedMode: ChatAgentMode;
+    disabled: boolean;
+}
 /**
  * Default English label values used when no labels are provided.
  */
@@ -525,6 +554,8 @@ interface AiChatProviderBaseProps {
     onSelectHistorySession?: ChatHistorySessionListHandlers['onSelectHistorySession'];
     /** Optional callback used when the active historical session needs older messages. */
     onLoadMoreHistoryMessages?: ChatHistorySessionListHandlers['onLoadMoreHistoryMessages'];
+    /** Optional renderer used to append custom actions to a history session item. */
+    renderSessionItemActions?: ChatSessionItemActionsRenderer;
     /**
      * Whether to enable image attachment uploads. Defaults to `true`.
      * Set to `false` to hide the upload button, disable paste-image handling,
@@ -584,12 +615,14 @@ type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
      * a streaming message, or an error to render.
      */
     onConversationStartedChange?: (started: boolean) => void;
+    /** Optional renderer used to append extra controls next to the mode selector. */
+    renderComposerModeAccessory?: (props: ChatComposerModeAccessoryRenderProps) => ReactNode;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, renderComposerModeAccessory, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -707,6 +740,7 @@ interface ChatComposerViewProps {
     modelLoadingLabel: string;
     modelLoadFailedLabel: string;
     modelUnavailableLabel: string;
+    modeAccessory?: ReactNode;
     onValueChange: (value: string) => void;
     onPickImages: (files: FileList | File[]) => void;
     onPasteImages: (files: File[]) => void;
@@ -722,7 +756,9 @@ interface ChatComposerViewProps {
     /** Called to send a new user message. */
     onSend: () => void | Promise<void>;
 }
-declare const ChatComposer: () => _emotion_react_jsx_runtime.JSX.Element;
+declare const ChatComposer: ({ renderModeAccessory, }?: {
+    renderModeAccessory?: (props: ChatComposerModeAccessoryRenderProps) => ReactNode;
+}) => _emotion_react_jsx_runtime.JSX.Element;
 
 declare const ChatConversationList: () => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -804,6 +840,10 @@ interface ChatContextValue {
     retryRef: MutableRefObject<(sessionId: string) => Promise<void>>;
     /** Stable ref populated by ChatComposer on mount; allows external controls to stop streaming. */
     stopRef: MutableRefObject<(sessionId: string) => Promise<void>>;
+    /** Current stop handler exposed as a plain function for render-time consumers. */
+    stopSession?: (sessionId: string) => Promise<void>;
+    /** Internal registration hook used by ChatComposer to refresh the stop handler. */
+    registerStopSession?: (handler: (sessionId: string) => Promise<void>) => void;
     /** Optional block renderer used to extend message rendering with custom block types. */
     renderMessageBlock?: ChatMessageBlockRenderer;
     /** Optional handler used to intercept questionnaire submissions before the default send flow. */
@@ -824,6 +864,8 @@ interface ChatContextValue {
     onSelectHistorySession?: ChatHistorySessionListHandlers['onSelectHistorySession'];
     /** Host callback triggered when a historical session needs older messages. */
     onLoadMoreHistoryMessages?: ChatHistorySessionListHandlers['onLoadMoreHistoryMessages'];
+    /** Optional renderer used to append custom actions to a history session item. */
+    renderSessionItemActions?: ChatSessionItemActionsRenderer;
 }
 
 /**
@@ -840,4 +882,4 @@ declare const useChatContext: () => ChatContextValue;
  */
 declare const useChatStore: <T>(selector: (state: ChatStore) => T) => T;
 
-export { AiChat, type AiChatLabels, type AiChatProps, AiChatProvider, type AiChatProviderProps, CHAT_AGENT_MODES, CHAT_MESSAGE_RENDER_ORDERS, type ChatAgentMode, ChatComposer, type ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, type ChatHistorySessionListHandlers, type ChatHistorySessionListState, type ChatHistorySessionMessageLoadArgs, type ChatHistorySessionMessagesPage, type ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, type ChatSessionMessageLoadStatus, type ChatStreamMessagePatch, type ChatStreamPacketTransformArgs, type ChatStreamPacketUpdate, type ChatSubmissionContext, ChatThread, type ChatToolExecutionPolicy, type ChatTransport, type ChatTransportStartStreamArgs, type CreateDefaultChatTransportOptions, DEFAULT_AI_CHAT_LABELS, DEFAULT_CHAT_AGENT_MODE, type DefaultChatTransportEndpoints, type DefaultChatTransportModelsResolver, type DefaultChatTransportRequestBodyBuilder, type DefaultChatTransportRequestBodyBuilderArgs, type ExecutionConfirmationSubmission, type ExecutionProposal, type NewChatTriggerRenderProps, type PlanQuestionOption, type PlanQuestionSubmissionDetail, type PlanQuestionnaire, type PlanQuestionnaireSubmission, type ResultSummary, type TransformChatStreamPacket, createDefaultChatTransport, useChatContext, useChatStore };
+export { AiChat, type AiChatLabels, type AiChatProps, AiChatProvider, type AiChatProviderProps, CHAT_AGENT_MODES, CHAT_MESSAGE_RENDER_ORDERS, type ChatAgentMode, ChatComposer, type ChatComposerModeAccessoryRenderProps, type ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, type ChatHistorySessionListHandlers, type ChatHistorySessionListState, type ChatHistorySessionMessageLoadArgs, type ChatHistorySessionMessagesPage, type ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, type ChatSessionItemActionRenderProps, type ChatSessionItemActionsRenderer, type ChatSessionMessageLoadStatus, type ChatStreamMessagePatch, type ChatStreamPacketTransformArgs, type ChatStreamPacketUpdate, type ChatSubmissionContext, ChatThread, type ChatToolExecutionPolicy, type ChatTransport, type ChatTransportStartStreamArgs, type CreateDefaultChatTransportOptions, DEFAULT_AI_CHAT_LABELS, DEFAULT_CHAT_AGENT_MODE, type DefaultChatTransportEndpoints, type DefaultChatTransportModelsResolver, type DefaultChatTransportRequestBodyBuilder, type DefaultChatTransportRequestBodyBuilderArgs, type ExecutionConfirmationSubmission, type ExecutionProposal, type NewChatTriggerRenderProps, type PlanQuestionOption, type PlanQuestionSubmissionDetail, type PlanQuestionnaire, type PlanQuestionnaireSubmission, type ResultSummary, type TransformChatStreamPacket, createDefaultChatTransport, useChatContext, useChatStore };

package/dist/index.d.ts

@@ -69,6 +69,21 @@ interface ChatHistorySessionListHandlers {
     onSelectHistorySession?: (session: ChatSession) => Promise<ChatHistorySessionMessagesPage | ChatMessage[] | void> | ChatHistorySessionMessagesPage | ChatMessage[] | void;
     onLoadMoreHistoryMessages?: (args: ChatHistorySessionMessageLoadArgs) => Promise<ChatHistorySessionMessagesPage | void> | ChatHistorySessionMessagesPage | void;
 }
+/**
+ * Arguments passed to custom history session action renderers.
+ */
+interface ChatSessionItemActionRenderProps {
+    session: ChatSession;
+    isActive: boolean;
+    isStreaming: boolean;
+    selectSession: () => Promise<void>;
+    startNewChat: () => void;
+    stopSession: () => Promise<void>;
+}
+/**
+ * Optional renderer used to append custom actions to a history session item.
+ */
+type ChatSessionItemActionsRenderer = (args: ChatSessionItemActionRenderProps) => ReactNode;
 /**
  * Client-side image attachment metadata kept in chat messages.
  */
@@ -144,7 +159,7 @@ interface PlanBooleanQuestion extends PlanQuestionBase {
  * Supported question variants in a plan questionnaire.
  */
 type PlanQuestion = PlanSingleSelectQuestion | PlanMultiSelectQuestion | PlanTextQuestion | PlanNumberQuestion | PlanBooleanQuestion;
-type PlanQuestionnaireStatus = 'expired' | 'failed';
+type PlanQuestionnaireStatus = 'expired' | 'failed' | 'submitted';
 /**
  * Merge behavior applied when a keyed structured block is patched repeatedly.
  */
@@ -177,6 +192,10 @@ interface PlanQuestionnaire {
     answers?: Partial<Record<string, PlanQuestionnaireAnswerValue>>;
     status?: PlanQuestionnaireStatus;
     statusMessage?: string;
+    /**
+     * Timeout in seconds for the questionnaire interaction.
+     */
+    timeoutSec?: number;
 }
 interface PlanQuestionSubmissionDetail {
     questionId: string;
@@ -478,6 +497,7 @@ interface AiChatLabels {
     questionnaireMultiSelectHint?: string;
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
+    questionnaireExpired?: string;
     modelLoading?: string;
     modelLoadFailed?: string;
     modelUnavailable?: string;
@@ -487,6 +507,8 @@ interface AiChatLabels {
     sessionHistoryLoading?: string;
     sessionHistoryLoadFailed?: string;
     sessionHistoryEmpty?: string;
+    questionnaireTitle?: string;
+    questionnaireConfirmInTime?: string;
 }
 /**
  * State and actions exposed to custom new-chat trigger renderers.
@@ -499,6 +521,13 @@ interface NewChatTriggerRenderProps {
     stopActiveSession: () => Promise<void>;
     startNewChat: () => Promise<void>;
 }
+/**
+ * State exposed to optional composer mode accessory renderers.
+ */
+interface ChatComposerModeAccessoryRenderProps {
+    selectedMode: ChatAgentMode;
+    disabled: boolean;
+}
 /**
  * Default English label values used when no labels are provided.
  */
@@ -525,6 +554,8 @@ interface AiChatProviderBaseProps {
     onSelectHistorySession?: ChatHistorySessionListHandlers['onSelectHistorySession'];
     /** Optional callback used when the active historical session needs older messages. */
     onLoadMoreHistoryMessages?: ChatHistorySessionListHandlers['onLoadMoreHistoryMessages'];
+    /** Optional renderer used to append custom actions to a history session item. */
+    renderSessionItemActions?: ChatSessionItemActionsRenderer;
     /**
      * Whether to enable image attachment uploads. Defaults to `true`.
      * Set to `false` to hide the upload button, disable paste-image handling,
@@ -584,12 +615,14 @@ type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
      * a streaming message, or an error to render.
      */
     onConversationStartedChange?: (started: boolean) => void;
+    /** Optional renderer used to append extra controls next to the mode selector. */
+    renderComposerModeAccessory?: (props: ChatComposerModeAccessoryRenderProps) => ReactNode;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, renderComposerModeAccessory, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -707,6 +740,7 @@ interface ChatComposerViewProps {
     modelLoadingLabel: string;
     modelLoadFailedLabel: string;
     modelUnavailableLabel: string;
+    modeAccessory?: ReactNode;
     onValueChange: (value: string) => void;
     onPickImages: (files: FileList | File[]) => void;
     onPasteImages: (files: File[]) => void;
@@ -722,7 +756,9 @@ interface ChatComposerViewProps {
     /** Called to send a new user message. */
     onSend: () => void | Promise<void>;
 }
-declare const ChatComposer: () => _emotion_react_jsx_runtime.JSX.Element;
+declare const ChatComposer: ({ renderModeAccessory, }?: {
+    renderModeAccessory?: (props: ChatComposerModeAccessoryRenderProps) => ReactNode;
+}) => _emotion_react_jsx_runtime.JSX.Element;
 
 declare const ChatConversationList: () => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -804,6 +840,10 @@ interface ChatContextValue {
     retryRef: MutableRefObject<(sessionId: string) => Promise<void>>;
     /** Stable ref populated by ChatComposer on mount; allows external controls to stop streaming. */
     stopRef: MutableRefObject<(sessionId: string) => Promise<void>>;
+    /** Current stop handler exposed as a plain function for render-time consumers. */
+    stopSession?: (sessionId: string) => Promise<void>;
+    /** Internal registration hook used by ChatComposer to refresh the stop handler. */
+    registerStopSession?: (handler: (sessionId: string) => Promise<void>) => void;
     /** Optional block renderer used to extend message rendering with custom block types. */
     renderMessageBlock?: ChatMessageBlockRenderer;
     /** Optional handler used to intercept questionnaire submissions before the default send flow. */
@@ -824,6 +864,8 @@ interface ChatContextValue {
     onSelectHistorySession?: ChatHistorySessionListHandlers['onSelectHistorySession'];
     /** Host callback triggered when a historical session needs older messages. */
     onLoadMoreHistoryMessages?: ChatHistorySessionListHandlers['onLoadMoreHistoryMessages'];
+    /** Optional renderer used to append custom actions to a history session item. */
+    renderSessionItemActions?: ChatSessionItemActionsRenderer;
 }
 
 /**
@@ -840,4 +882,4 @@ declare const useChatContext: () => ChatContextValue;
  */
 declare const useChatStore: <T>(selector: (state: ChatStore) => T) => T;
 
-export { AiChat, type AiChatLabels, type AiChatProps, AiChatProvider, type AiChatProviderProps, CHAT_AGENT_MODES, CHAT_MESSAGE_RENDER_ORDERS, type ChatAgentMode, ChatComposer, type ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, type ChatHistorySessionListHandlers, type ChatHistorySessionListState, type ChatHistorySessionMessageLoadArgs, type ChatHistorySessionMessagesPage, type ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, type ChatSessionMessageLoadStatus, type ChatStreamMessagePatch, type ChatStreamPacketTransformArgs, type ChatStreamPacketUpdate, type ChatSubmissionContext, ChatThread, type ChatToolExecutionPolicy, type ChatTransport, type ChatTransportStartStreamArgs, type CreateDefaultChatTransportOptions, DEFAULT_AI_CHAT_LABELS, DEFAULT_CHAT_AGENT_MODE, type DefaultChatTransportEndpoints, type DefaultChatTransportModelsResolver, type DefaultChatTransportRequestBodyBuilder, type DefaultChatTransportRequestBodyBuilderArgs, type ExecutionConfirmationSubmission, type ExecutionProposal, type NewChatTriggerRenderProps, type PlanQuestionOption, type PlanQuestionSubmissionDetail, type PlanQuestionnaire, type PlanQuestionnaireSubmission, type ResultSummary, type TransformChatStreamPacket, createDefaultChatTransport, useChatContext, useChatStore };
+export { AiChat, type AiChatLabels, type AiChatProps, AiChatProvider, type AiChatProviderProps, CHAT_AGENT_MODES, CHAT_MESSAGE_RENDER_ORDERS, type ChatAgentMode, ChatComposer, type ChatComposerModeAccessoryRenderProps, type ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, type ChatHistorySessionListHandlers, type ChatHistorySessionListState, type ChatHistorySessionMessageLoadArgs, type ChatHistorySessionMessagesPage, type ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, type ChatSessionItemActionRenderProps, type ChatSessionItemActionsRenderer, type ChatSessionMessageLoadStatus, type ChatStreamMessagePatch, type ChatStreamPacketTransformArgs, type ChatStreamPacketUpdate, type ChatSubmissionContext, ChatThread, type ChatToolExecutionPolicy, type ChatTransport, type ChatTransportStartStreamArgs, type CreateDefaultChatTransportOptions, DEFAULT_AI_CHAT_LABELS, DEFAULT_CHAT_AGENT_MODE, type DefaultChatTransportEndpoints, type DefaultChatTransportModelsResolver, type DefaultChatTransportRequestBodyBuilder, type DefaultChatTransportRequestBodyBuilderArgs, type ExecutionConfirmationSubmission, type ExecutionProposal, type NewChatTriggerRenderProps, type PlanQuestionOption, type PlanQuestionSubmissionDetail, type PlanQuestionnaire, type PlanQuestionnaireSubmission, type ResultSummary, type TransformChatStreamPacket, createDefaultChatTransport, useChatContext, useChatStore };