@somecat/ai-assist-sdk 1.0.0 → 1.1.0

package/dist/vue/components/answer/composables/useChatActions.d.ts

@@ -0,0 +1,65 @@
+import { Ref } from '../../../../../vue/dist/vue.esm-bundler.js';
+import { ChatMessage, MessageStatus, AiAssistConfig } from '../../../../core/types';
+interface UseChatActionsParams {
+    messages: Ref<ChatMessage[]>;
+    userInput: Ref<string>;
+    isGenerating: Ref<boolean>;
+    lastUserMessage: Ref<string>;
+    conversationId: Ref<string>;
+    doStreamRequest: (apiUrl: string, bodyData: Record<string, any>, aiIndex: number, signal: AbortSignal, isRetry?: boolean) => Promise<void>;
+    issTop: Ref<boolean>;
+    scrollToBottom: () => void;
+    STATUS: Record<string, MessageStatus>;
+    cfg: AiAssistConfig;
+}
+/**
+ * 对话操作：发送消息 / 重新生成 / 停止 / 加载历史会话
+ *
+ * 内部管理两个 AbortController（first / again）用于中断 SSE 连接。
+ */
+export declare function useChatActions({ messages, userInput, isGenerating, lastUserMessage, conversationId, doStreamRequest, issTop, scrollToBottom, STATUS, cfg, }: UseChatActionsParams): {
+    sendMessage: () => Promise<void>;
+    regenerateResponse: () => Promise<void>;
+    toggleStop: () => Promise<void>;
+    goHistoryMessage: (appConversationId: string) => Promise<void>;
+    initConversation: () => Promise<void>;
+    controllers: {
+        first: {
+            readonly signal: {
+                readonly aborted: boolean;
+                onabort: ((this: AbortSignal, ev: Event) => any) | null;
+                readonly reason: any;
+                throwIfAborted: () => void;
+                addEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+                };
+                removeEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+                };
+                dispatchEvent: (event: Event) => boolean;
+            };
+            abort: (reason?: any) => void;
+        };
+        again: {
+            readonly signal: {
+                readonly aborted: boolean;
+                onabort: ((this: AbortSignal, ev: Event) => any) | null;
+                readonly reason: any;
+                throwIfAborted: () => void;
+                addEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+                };
+                removeEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+                };
+                dispatchEvent: (event: Event) => boolean;
+            };
+            abort: (reason?: any) => void;
+        };
+    };
+};
+export {};

package/dist/vue/components/answer/composables/useCodeBlocks.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 代码块增强：为 markdown 渲染出的 <pre> 添加语言标签和复制按钮
+ */
+export declare function useCodeBlocks(): {
+    enhanceCodeBlocks: (container: HTMLElement) => void;
+};

package/dist/vue/components/answer/composables/useMessagesBatch.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from '../../../../../vue/dist/vue.esm-bundler.js';
+import { ChatMessage } from '../../../../core/types';
+/**
+ * RAF 批量更新：将同一帧内的多次 messages 赋值合并为一次，避免频繁触发响应式更新。
+ *
+ * - batchMessagesUpdate: 传入更新函数，延迟到下一帧统一写入
+ * - flushMessagesBatch: 立即刷出所有待处理更新（用于终止/错误等需要即时反馈的场景）
+ */
+export declare function useMessagesBatch(messages: Ref<ChatMessage[]>): {
+    batchMessagesUpdate: (updater: (msgs: ChatMessage[]) => ChatMessage[]) => void;
+    flushMessagesBatch: () => void;
+};

package/dist/vue/components/answer/composables/useSSEStream.d.ts

@@ -0,0 +1,27 @@
+import { Ref } from '../../../../../vue/dist/vue.esm-bundler.js';
+import { ChatMessage, MessageStatus, AiAssistConfig } from '../../../../core/types';
+interface UseSSEStreamParams {
+    messages: Ref<ChatMessage[]>;
+    isGenerating: Ref<boolean>;
+    lastUserMessage: Ref<string>;
+    batchMessagesUpdate: (updater: (msgs: ChatMessage[]) => ChatMessage[]) => void;
+    flushMessagesBatch: () => void;
+    STATUS: Record<string, MessageStatus>;
+    cfg: AiAssistConfig;
+}
+/**
+ * SSE 流式请求：处理 think_message / agent_thought / message 等事件的分段拼接与状态流转。
+ *
+ * 内部管理：
+ * - segmentsMap: 每条 AI 消息的分段数组（支持 thinking/agent_thought/answer 穿插）
+ * - currentSegType: 当前正在写入的 segment 类型
+ * - thinkingStartTimes / agentThoughtStartTimes: 用于计算耗时
+ * - issTop: 是否已手动停止
+ *
+ * 对外暴露 doStreamRequest 与 issTop（toggleStop 需读写）。
+ */
+export declare function useSSEStream({ messages, isGenerating, lastUserMessage, batchMessagesUpdate, flushMessagesBatch, STATUS, cfg, }: UseSSEStreamParams): {
+    doStreamRequest: (apiUrl: string, bodyData: Record<string, any>, aiIndex: number, signal: AbortSignal, isRetry?: boolean) => Promise<void>;
+    issTop: Ref<boolean, boolean>;
+};
+export {};

package/dist/vue/components/answer/composables/useScrollManager.d.ts

@@ -0,0 +1,12 @@
+import { Ref } from '../../../../../vue/dist/vue.esm-bundler.js';
+/**
+ * 聊天容器滚动状态管理
+ * - isAtBottom: 用户是否滚动到底部
+ * - hasScroll: 容器是否出现滚动条
+ */
+export declare function useScrollManager(chatBoxRef: Ref<HTMLElement | null>): {
+    isAtBottom: Ref<boolean, boolean>;
+    hasScroll: Ref<boolean, boolean>;
+    scrollToBottom: () => void;
+    checkScrollStatus: () => void;
+};

package/dist/vue/components/answer/composables/useTypewriter.d.ts

@@ -0,0 +1,21 @@
+import { Ref } from '../../../../../vue/dist/vue.esm-bundler.js';
+import { ChatMessage, MessageSegment, MessageStatus } from '../../../../core/types';
+/**
+ * 打字机效果：对正在流式输出（ANSWERING）的 AI 消息做逐字/渐进显示动画。
+ *
+ * - displayedContent: 每条 AI 消息当前已渲染的内容（可能是 content 的子串）
+ * - streamingIndexRef: 每条消息已显示到的字符位置
+ * - getSegmentDisplayContent: 对 segments 模式下最后一个 answer segment 应用打字机截断
+ *
+ * @param messages    消息列表 ref
+ * @param scrollToBottom  滚动到底部回调（打字机推进时调用）
+ * @param ANSWERING   流式回答中的状态值
+ */
+export declare function useTypewriter(messages: Ref<ChatMessage[]>, scrollToBottom: () => void, ANSWERING: MessageStatus): {
+    displayedContent: import('../../../../../vue/dist/vue.esm-bundler.js').Reactive<Map<number, string>>;
+    streamingIndexRef: Ref<Map<number, number> & Omit<Map<number, number>, keyof Map<any, any>>, Map<number, number> | (Map<number, number> & Omit<Map<number, number>, keyof Map<any, any>>)>;
+    startTypewriter: () => void;
+    flushTypewriter: () => void;
+    getSegmentDisplayContent: (msgIdx: number, segIdx: number, seg: MessageSegment, msg: ChatMessage) => string;
+    stopTypewriter: () => void;
+};