@kweaver-ai/chatkit 0.1.14 → 0.1.16

package/dist/components/base/ChatKitBase.d.ts

@@ -18,6 +18,13 @@ export interface ChatKitBaseProps {
     token?: string;
     /** 刷新 token 的方法，由集成方传入 */
     refreshToken?: () => Promise<string>;
+    /**
+     * 初始用户问题。
+     *
+     * - 外层在挂载 Assistant / Copilot 等组件时传入
+     * - 当组件首次可见且当前没有任何消息时，会自动发送该问题并触发问答
+     */
+    initialQuestion?: string;
 }
 /**
  * ChatKitBase 组件的状态接口
@@ -56,6 +63,20 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      */
     private isInitializing;
     private hasInitialized;
+    /**
+     * 会话代数：用于区分「旧会话的流式更新」和「新会话」
+     * 每次清空/新建会话时自增，流式处理只在代数未变化时才继续写入 state
+     */
+    private conversationSeq;
+    /**
+     * 当前流式请求的 AbortController
+     * 子类在发起流式 fetch 时应设置该字段，便于在 handleStop / 新建会话时主动中断连接
+     */
+    protected currentStreamController?: AbortController;
+    /**
+     * 是否已经根据 initialQuestion 触发过一次自动发送
+     */
+    private hasSentInitialQuestion;
     /**
      * 流式响应时是否处于「按 chunk 批处理」中，避免同一 chunk 内多行事件触发多次 setState 导致 Maximum update depth exceeded
      */
@@ -85,6 +106,16 @@ export declare abstract class ChatKitBase<P extends ChatKitBaseProps = ChatKitBa
      * 仅在组件首次可见时调用，防止重复初始化
      */
     private initializeConversation;
+    /**
+     * 根据 props.initialQuestion 在合适的时机自动触发一次问答
+     *
+     * 触发条件：
+     * - 组件当前处于可见状态（visible !== false）
+     * - props.initialQuestion 为非空字符串
+     * - 当前还没有任何对话消息（messages.length === 0）
+     * - 仅触发一次（hasSentInitialQuestion 为 false）
+     */
+    private trySendInitialQuestion;
     /**
      * 获取开场白和预置问题 (抽象方法，由子类实现)
      * 该方法需要由子类继承并重写，以适配扣子、Dify 等 LLMOps 平台的接口

package/dist/components/base/assistant/AssistantBase.d.ts

@@ -46,7 +46,7 @@ export declare abstract class AssistantBase<P extends AssistantBaseProps = Assis
     /**
      * 处理新建对话
      */
-    handleNewChat: () => void;
+    handleNewChat: () => Promise<void>;
     /**
      * 处理加载指定会话
      */

package/dist/components/dip/DIPBase.d.ts

@@ -427,6 +427,7 @@ export declare function DIPBaseMixin<TBase extends Constructor>(Base: TBase): {
         /**
          * 终止会话
          * 调用 DIP 的 /app/{agent_key}/chat/termination 接口终止指定会话
+         * 若返回 401 会先调用 refreshToken 获取新 token 并重试一次
          * @param conversationId 要终止的会话 ID
          * @returns 返回 Promise，成功时 resolve，失败时 reject
          */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kweaver-ai/chatkit",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "publishConfig": {
     "access": "public"
   },