@xinghunm/ai-chat 1.2.1 → 1.3.0

package/dist/index.d.mts

@@ -264,6 +264,7 @@ interface ChatMessage {
     sessionId: string;
     role: ChatRole;
     content: string;
+    skills?: string[];
     blocks?: ChatMessageBlock[];
     attachments?: ChatImageAttachment[];
     localOnly?: boolean;
@@ -297,6 +298,8 @@ interface ChatTransportStartStreamArgs {
     mode: ChatAgentMode;
     /** User message content that should be sent to the backend. */
     content: string;
+    /** Optional skills selected in the composer and sent alongside the user message. */
+    skills?: string[];
     /**
      * Optional image attachments selected in the composer and sent alongside the text.
      */
@@ -318,6 +321,8 @@ interface ChatTransportStartStreamArgs {
 interface ChatTransport {
     /** Loads the model list shown by the composer model selector. */
     getModels: () => Promise<ChatModelsResponse>;
+    /** Optional skill catalog loader used by the composer slash menu. */
+    getSkills?: () => Promise<ChatSkillsResponse>;
     /** Starts a single assistant response stream for the current user message. */
     startStream: (args: ChatTransportStartStreamArgs) => Promise<void>;
     /** Requests termination of the active backend stream for a session. */
@@ -364,6 +369,12 @@ interface ChatModel {
 interface ChatModelsResponse {
     data: ChatModel[];
 }
+/**
+ * Response payload returned by the optional chat skills endpoint.
+ */
+interface ChatSkillsResponse {
+    skills: string[];
+}
 /**
  * Response payload returned after a terminate request has been processed.
  */
@@ -430,6 +441,9 @@ interface AiChatLabels {
     questionnaireMultiSelectHint?: string;
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
+    skillLoading?: string;
+    skillEmpty?: string;
+    removeSkillAriaLabel?: string;
 }
 /**
  * State and actions exposed to custom new-chat trigger renderers.
@@ -507,12 +521,24 @@ type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
     showNewChatButton?: boolean;
     /** Optional renderer used to override the lightweight new-chat trigger UI. */
     renderNewChatTrigger?: (props: NewChatTriggerRenderProps) => ReactNode;
+    /**
+     * When true, only renders the composer before the first message is sent.
+     * Once a conversation starts, the full thread layout is shown automatically.
+     */
+    showComposerOnlyBeforeFirstMessage?: boolean;
+    /**
+     * Called whenever the "conversation started" state changes.
+     *
+     * A conversation is considered started after the active session has messages,
+     * a streaming message, or an error to render.
+     */
+    onConversationStartedChange?: (started: boolean) => void;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -520,6 +546,8 @@ declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatT
 interface DefaultChatTransportEndpoints {
     /** Relative path used to fetch the available model list. */
     models?: string;
+    /** Relative path used to fetch the available skills. */
+    skills?: string;
     /** Relative path used to start a streaming chat completion. */
     completions?: string;
     /** Relative path used to request stream termination. */
@@ -544,6 +572,7 @@ interface DefaultChatTransportRequestBodyBuilderArgs {
     model: string;
     mode: ChatAgentMode;
     content: string;
+    skills?: string[];
     attachments?: ChatImageAttachment[];
 }
 /**
@@ -555,6 +584,7 @@ type DefaultChatTransportRequestBodyBuilder = (args: DefaultChatTransportRequest
  * Optional model resolver used to override the default `/models` request.
  */
 type DefaultChatTransportModelsResolver = () => Promise<ChatModelsResponse>;
+type DefaultChatTransportSkillsResolver = () => Promise<ChatSkillsResponse>;
 /**
  * Options for the built-in HTTP transport adapter.
  */
@@ -563,12 +593,16 @@ interface CreateDefaultChatTransportOptions {
     apiBaseUrl: string;
     /** Authorization header value forwarded to the backend. */
     authToken: string;
+    /** Optional extra headers appended to every request sent by the default transport. */
+    headers?: Record<string, string>;
     /** Optional tool execution policy translated into stream request headers. */
     toolExecutionPolicy?: ChatToolExecutionPolicy;
     /** Optional extra headers appended to each streaming chat completion request. */
     streamHeaders?: Record<string, string>;
     /** Optional resolver used to override the built-in model catalog request. */
     resolveModels?: DefaultChatTransportModelsResolver;
+    /** Optional resolver used to override the built-in skills catalog request. */
+    resolveSkills?: DefaultChatTransportSkillsResolver;
     /** Optional builder used to override the built-in chat completion request body. */
     buildRequestBody?: DefaultChatTransportRequestBodyBuilder;
     /** Optional transformer used to normalize custom stream packets. */
@@ -581,7 +615,7 @@ interface CreateDefaultChatTransportOptions {
 /**
  * Creates the built-in transport backed by the current HTTP chat API.
  */
-declare const createDefaultChatTransport: ({ apiBaseUrl, authToken, toolExecutionPolicy, streamHeaders, resolveModels, buildRequestBody, transformStreamPacket, endpoints, axiosInstance, }: CreateDefaultChatTransportOptions) => ChatTransport;
+declare const createDefaultChatTransport: ({ apiBaseUrl, authToken, headers, toolExecutionPolicy, streamHeaders, resolveModels, resolveSkills, buildRequestBody, transformStreamPacket, endpoints, axiosInstance, }: CreateDefaultChatTransportOptions) => ChatTransport;
 
 declare const ChatThread: () => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -594,10 +628,13 @@ interface ChatComposerViewProps {
     attachments: ChatImageAttachment[];
     attachmentNotice?: 'limit_reached' | null;
     attachmentLimitNotice: string;
+    selectedSkills: string[];
     selectedModel: string;
     selectedMode: ChatAgentMode;
     availableModels: ChatModel[];
+    availableSkills: string[];
     isModelsLoading: boolean;
+    isSkillsLoading: boolean;
     isModelsError: boolean;
     hasModels: boolean;
     /** Whether a streaming response is currently in progress. */
@@ -613,13 +650,19 @@ interface ChatComposerViewProps {
     };
     expandComposerAriaLabel: string;
     collapseComposerAriaLabel: string;
+    skillLoadingLabel: string;
+    skillEmptyLabel: string;
+    removeSkillAriaLabel: string;
     onValueChange: (value: string) => void;
     onPickImages: (files: FileList | File[]) => void;
     onPasteImages: (files: File[]) => void;
     onRemoveAttachment: (attachmentId: string) => void;
+    onAddSkill: (skill: string) => void;
+    onRemoveSkill: (skill: string) => void;
     onSelectedModelChange: (value: string) => void;
     onSelectedModeChange: (value: ChatAgentMode) => void;
     onReloadModels: () => void;
+    onOpenSkillPicker: () => void;
     /** Called to abort the active streaming response. */
     onStop: () => void | Promise<void>;
     /** Called to send a new user message. */
@@ -666,6 +709,8 @@ interface ChatSendRefOptions {
     sessionId?: string;
     /** Whether to consume the composer attachment draft. Defaults to true for composer sends. */
     includeComposerAttachments?: boolean;
+    /** Whether to consume the composer skill draft. Defaults to true for composer sends. */
+    includeComposerSkills?: boolean;
 }
 interface ChatContextValue {
     store: ChatStoreInstance;

package/dist/index.d.ts

@@ -264,6 +264,7 @@ interface ChatMessage {
     sessionId: string;
     role: ChatRole;
     content: string;
+    skills?: string[];
     blocks?: ChatMessageBlock[];
     attachments?: ChatImageAttachment[];
     localOnly?: boolean;
@@ -297,6 +298,8 @@ interface ChatTransportStartStreamArgs {
     mode: ChatAgentMode;
     /** User message content that should be sent to the backend. */
     content: string;
+    /** Optional skills selected in the composer and sent alongside the user message. */
+    skills?: string[];
     /**
      * Optional image attachments selected in the composer and sent alongside the text.
      */
@@ -318,6 +321,8 @@ interface ChatTransportStartStreamArgs {
 interface ChatTransport {
     /** Loads the model list shown by the composer model selector. */
     getModels: () => Promise<ChatModelsResponse>;
+    /** Optional skill catalog loader used by the composer slash menu. */
+    getSkills?: () => Promise<ChatSkillsResponse>;
     /** Starts a single assistant response stream for the current user message. */
     startStream: (args: ChatTransportStartStreamArgs) => Promise<void>;
     /** Requests termination of the active backend stream for a session. */
@@ -364,6 +369,12 @@ interface ChatModel {
 interface ChatModelsResponse {
     data: ChatModel[];
 }
+/**
+ * Response payload returned by the optional chat skills endpoint.
+ */
+interface ChatSkillsResponse {
+    skills: string[];
+}
 /**
  * Response payload returned after a terminate request has been processed.
  */
@@ -430,6 +441,9 @@ interface AiChatLabels {
     questionnaireMultiSelectHint?: string;
     questionnaireOtherOptionLabel?: string;
     questionnaireOtherPlaceholder?: string;
+    skillLoading?: string;
+    skillEmpty?: string;
+    removeSkillAriaLabel?: string;
 }
 /**
  * State and actions exposed to custom new-chat trigger renderers.
@@ -507,12 +521,24 @@ type AiChatProps = Omit<AiChatProviderProps, 'children'> & {
     showNewChatButton?: boolean;
     /** Optional renderer used to override the lightweight new-chat trigger UI. */
     renderNewChatTrigger?: (props: NewChatTriggerRenderProps) => ReactNode;
+    /**
+     * When true, only renders the composer before the first message is sent.
+     * Once a conversation starts, the full thread layout is shown automatically.
+     */
+    showComposerOnlyBeforeFirstMessage?: boolean;
+    /**
+     * Called whenever the "conversation started" state changes.
+     *
+     * A conversation is considered started after the active session has messages,
+     * a streaming message, or an error to render.
+     */
+    onConversationStartedChange?: (started: boolean) => void;
 };
 /**
  * Top-level AI chat component. Wraps AiChatProvider and composes the full
  * chat UI: optional conversation sidebar + thread + composer.
  */
-declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
+declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatTrigger, showComposerOnlyBeforeFirstMessage, onConversationStartedChange, ...providerProps }: AiChatProps) => _emotion_react_jsx_runtime.JSX.Element;
 
 /**
  * Endpoint overrides for the built-in HTTP transport adapter.
@@ -520,6 +546,8 @@ declare const AiChat: ({ showConversationList, showNewChatButton, renderNewChatT
 interface DefaultChatTransportEndpoints {
     /** Relative path used to fetch the available model list. */
     models?: string;
+    /** Relative path used to fetch the available skills. */
+    skills?: string;
     /** Relative path used to start a streaming chat completion. */
     completions?: string;
     /** Relative path used to request stream termination. */
@@ -544,6 +572,7 @@ interface DefaultChatTransportRequestBodyBuilderArgs {
     model: string;
     mode: ChatAgentMode;
     content: string;
+    skills?: string[];
     attachments?: ChatImageAttachment[];
 }
 /**
@@ -555,6 +584,7 @@ type DefaultChatTransportRequestBodyBuilder = (args: DefaultChatTransportRequest
  * Optional model resolver used to override the default `/models` request.
  */
 type DefaultChatTransportModelsResolver = () => Promise<ChatModelsResponse>;
+type DefaultChatTransportSkillsResolver = () => Promise<ChatSkillsResponse>;
 /**
  * Options for the built-in HTTP transport adapter.
  */
@@ -563,12 +593,16 @@ interface CreateDefaultChatTransportOptions {
     apiBaseUrl: string;
     /** Authorization header value forwarded to the backend. */
     authToken: string;
+    /** Optional extra headers appended to every request sent by the default transport. */
+    headers?: Record<string, string>;
     /** Optional tool execution policy translated into stream request headers. */
     toolExecutionPolicy?: ChatToolExecutionPolicy;
     /** Optional extra headers appended to each streaming chat completion request. */
     streamHeaders?: Record<string, string>;
     /** Optional resolver used to override the built-in model catalog request. */
     resolveModels?: DefaultChatTransportModelsResolver;
+    /** Optional resolver used to override the built-in skills catalog request. */
+    resolveSkills?: DefaultChatTransportSkillsResolver;
     /** Optional builder used to override the built-in chat completion request body. */
     buildRequestBody?: DefaultChatTransportRequestBodyBuilder;
     /** Optional transformer used to normalize custom stream packets. */
@@ -581,7 +615,7 @@ interface CreateDefaultChatTransportOptions {
 /**
  * Creates the built-in transport backed by the current HTTP chat API.
  */
-declare const createDefaultChatTransport: ({ apiBaseUrl, authToken, toolExecutionPolicy, streamHeaders, resolveModels, buildRequestBody, transformStreamPacket, endpoints, axiosInstance, }: CreateDefaultChatTransportOptions) => ChatTransport;
+declare const createDefaultChatTransport: ({ apiBaseUrl, authToken, headers, toolExecutionPolicy, streamHeaders, resolveModels, resolveSkills, buildRequestBody, transformStreamPacket, endpoints, axiosInstance, }: CreateDefaultChatTransportOptions) => ChatTransport;
 
 declare const ChatThread: () => _emotion_react_jsx_runtime.JSX.Element;
 
@@ -594,10 +628,13 @@ interface ChatComposerViewProps {
     attachments: ChatImageAttachment[];
     attachmentNotice?: 'limit_reached' | null;
     attachmentLimitNotice: string;
+    selectedSkills: string[];
     selectedModel: string;
     selectedMode: ChatAgentMode;
     availableModels: ChatModel[];
+    availableSkills: string[];
     isModelsLoading: boolean;
+    isSkillsLoading: boolean;
     isModelsError: boolean;
     hasModels: boolean;
     /** Whether a streaming response is currently in progress. */
@@ -613,13 +650,19 @@ interface ChatComposerViewProps {
     };
     expandComposerAriaLabel: string;
     collapseComposerAriaLabel: string;
+    skillLoadingLabel: string;
+    skillEmptyLabel: string;
+    removeSkillAriaLabel: string;
     onValueChange: (value: string) => void;
     onPickImages: (files: FileList | File[]) => void;
     onPasteImages: (files: File[]) => void;
     onRemoveAttachment: (attachmentId: string) => void;
+    onAddSkill: (skill: string) => void;
+    onRemoveSkill: (skill: string) => void;
     onSelectedModelChange: (value: string) => void;
     onSelectedModeChange: (value: ChatAgentMode) => void;
     onReloadModels: () => void;
+    onOpenSkillPicker: () => void;
     /** Called to abort the active streaming response. */
     onStop: () => void | Promise<void>;
     /** Called to send a new user message. */
@@ -666,6 +709,8 @@ interface ChatSendRefOptions {
     sessionId?: string;
     /** Whether to consume the composer attachment draft. Defaults to true for composer sends. */
     includeComposerAttachments?: boolean;
+    /** Whether to consume the composer skill draft. Defaults to true for composer sends. */
+    includeComposerSkills?: boolean;
 }
 interface ChatContextValue {
     store: ChatStoreInstance;