@xinghunm/ai-chat 1.2.0 → 1.2.1

package/dist/index.d.mts

@@ -431,6 +431,17 @@ interface AiChatLabels {
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
 }
+/**
+ * State and actions exposed to custom new-chat trigger renderers.
+ */
+interface NewChatTriggerRenderProps {
+    activeSessionId: string | null;
+    isStreaming: boolean;
+    isStopping: boolean;
+    createNewSession: () => void;
+    stopActiveSession: () => Promise<void>;
+    startNewChat: () => Promise<void>;
+}
 /**
  * Default English label values used when no labels are provided.
  */
@@ -492,12 +503,16 @@ declare const AiChatProvider: (props: AiChatProviderProps) => _emotion_react_jsx
 type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
     /** When true, renders the conversation list sidebar. Defaults to false. */
     showConversationList?: boolean;
+    /** When true, renders a lightweight new-chat button without the full conversation list. */
+    showNewChatButton?: boolean;
+    /** Optional renderer used to override the lightweight new-chat trigger UI. */
+    renderNewChatTrigger?: (props: NewChatTriggerRenderProps) => ReactNode;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -626,6 +641,7 @@ interface ChatState {
 }
 interface ChatActions {
     createSession: (session: ChatSession) => void;
+    startNewChat: () => void;
     setActiveSession: (sessionId: string | null) => void;
     replaceSessionId: (previousSessionId: string, nextSessionId: string) => void;
     setPreferredMode: (mode: ChatAgentMode) => void;
@@ -645,6 +661,12 @@ type ChatStore = ChatState & ChatActions;
 type ChatStoreInstance = ReturnType<typeof createChatStore>;
 declare const createChatStore: (initialState?: Partial<Pick<ChatState, "preferredMode">>) => zustand_vanilla.StoreApi<ChatStore>;
 
+interface ChatSendRefOptions {
+    /** Explicit target session for programmatic sends triggered from a thread card. */
+    sessionId?: string;
+    /** Whether to consume the composer attachment draft. Defaults to true for composer sends. */
+    includeComposerAttachments?: boolean;
+}
 interface ChatContextValue {
     store: ChatStoreInstance;
     transport: ChatTransport;
@@ -656,9 +678,11 @@ interface ChatContextValue {
     authToken?: string;
     labels: Required<AiChatLabels>;
     /** Stable ref populated by ChatComposer on mount; allows ChatThread to trigger sends. */
-    sendRef: MutableRefObject<(content: string) => Promise<void>>;
-    /** Stable ref populated by ChatComposer on mount; allows ChatThread to replay the last request. */
-    retryRef: MutableRefObject<() => Promise<void>>;
+    sendRef: MutableRefObject<(content: string, options?: ChatSendRefOptions) => Promise<void>>;
+    /** Stable ref populated by ChatComposer on mount; allows ChatThread to replay a session request. */
+    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>>;
     /** 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. */
@@ -687,4 +711,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 ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, 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 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 ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, 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 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

@@ -431,6 +431,17 @@ interface AiChatLabels {
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
 }
+/**
+ * State and actions exposed to custom new-chat trigger renderers.
+ */
+interface NewChatTriggerRenderProps {
+    activeSessionId: string | null;
+    isStreaming: boolean;
+    isStopping: boolean;
+    createNewSession: () => void;
+    stopActiveSession: () => Promise<void>;
+    startNewChat: () => Promise<void>;
+}
 /**
  * Default English label values used when no labels are provided.
  */
@@ -492,12 +503,16 @@ declare const AiChatProvider: (props: AiChatProviderProps) => _emotion_react_jsx
 type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
     /** When true, renders the conversation list sidebar. Defaults to false. */
     showConversationList?: boolean;
+    /** When true, renders a lightweight new-chat button without the full conversation list. */
+    showNewChatButton?: boolean;
+    /** Optional renderer used to override the lightweight new-chat trigger UI. */
+    renderNewChatTrigger?: (props: NewChatTriggerRenderProps) => ReactNode;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -626,6 +641,7 @@ interface ChatState {
 }
 interface ChatActions {
     createSession: (session: ChatSession) => void;
+    startNewChat: () => void;
     setActiveSession: (sessionId: string | null) => void;
     replaceSessionId: (previousSessionId: string, nextSessionId: string) => void;
     setPreferredMode: (mode: ChatAgentMode) => void;
@@ -645,6 +661,12 @@ type ChatStore = ChatState & ChatActions;
 type ChatStoreInstance = ReturnType<typeof createChatStore>;
 declare const createChatStore: (initialState?: Partial<Pick<ChatState, "preferredMode">>) => zustand_vanilla.StoreApi<ChatStore>;
 
+interface ChatSendRefOptions {
+    /** Explicit target session for programmatic sends triggered from a thread card. */
+    sessionId?: string;
+    /** Whether to consume the composer attachment draft. Defaults to true for composer sends. */
+    includeComposerAttachments?: boolean;
+}
 interface ChatContextValue {
     store: ChatStoreInstance;
     transport: ChatTransport;
@@ -656,9 +678,11 @@ interface ChatContextValue {
     authToken?: string;
     labels: Required<AiChatLabels>;
     /** Stable ref populated by ChatComposer on mount; allows ChatThread to trigger sends. */
-    sendRef: MutableRefObject<(content: string) => Promise<void>>;
-    /** Stable ref populated by ChatComposer on mount; allows ChatThread to replay the last request. */
-    retryRef: MutableRefObject<() => Promise<void>>;
+    sendRef: MutableRefObject<(content: string, options?: ChatSendRefOptions) => Promise<void>>;
+    /** Stable ref populated by ChatComposer on mount; allows ChatThread to replay a session request. */
+    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>>;
     /** 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. */
@@ -687,4 +711,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 ChatImageAttachment, type ChatMessage, type ChatMessageBlock, type ChatMessageBlockRenderer, type ChatMessageBlockRendererProps, type ChatMessageRenderOrder, type ChatMessageStatus, type ChatModel, type ChatParameterSummaryItem, type ChatQuestionnaireSubmitHandler, type ChatRole, type ChatSession, 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 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 ChatComposerViewProps, type ChatConfirmationSubmitHandler, ChatConversationList, 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 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 };