@veltra/ai 1.4.0 → 2.1.0

package/src/types/ai-chat.ts

@@ -1,12 +1,15 @@
 import type { DeconstructValue } from '@veltra/utils'
+import type { Ref } from 'vue'
 
 import type {
   ChatAttachment,
   ChatMessage,
+  ChatQueuedMessage,
   ChatTool,
   ChatToolCall,
   ChatTransport
 } from '../chat/types'
+import type { ChatModelOption } from '../providers'
 
 export interface AiChatProps {
   /** 传输层（必填），可使用导出的 createOpenAITransport() 创建 */
@@ -15,10 +18,24 @@ export interface AiChatProps {
   tools?: ChatTool[]
   /** 系统提示词 */
   systemPrompt?: string
+  /**
+   * 单次发送允许的最大生成轮次（一轮 = 一次模型生成 + 可能的工具执行），默认 10。
+   * 模型持续调用工具不收敛时，达到上限即停止继续请求并发出 finish，防止失控循环。
+   */
+  maxToolRounds?: number
   /** 消息列表，支持 v-model:messages 受控 */
   messages?: ChatMessage[]
-  /** 空状态欢迎语 */
-  welcome?: string
+  /**
+   * 可选模型列表；有值则在输入栏展示模型选择器。
+   * 可从 createOpenAITransport() 返回值的 `.models` 直接传入。
+   */
+  models?: ChatModelOption[]
+  /** 当前模型 id，支持 v-model:model */
+  model?: string
+  /** 当前推理等级，支持 v-model:reasoning-level */
+  reasoningLevel?: string
+  /** 空状态欢迎项（快捷提问，点击即发送）；字符串按单项处理 */
+  welcome?: string | string[]
   /** 输入框占位文本 */
   placeholder?: string
   /** 附件 accept 类型，默认 image/* */
@@ -32,9 +49,13 @@ export interface AiChatProps {
 export interface AiChatEmits {
   /** 消息列表变化 */
   (e: 'update:messages', messages: ChatMessage[]): void
+  /** 当前模型变化 */
+  (e: 'update:model', model: string | undefined): void
+  /** 当前推理等级变化 */
+  (e: 'update:reasoningLevel', reasoningLevel: string | undefined): void
   /** 用户发送消息 */
   (e: 'send', message: ChatMessage): void
-  /** 一轮对话完成（无更多工具调用） */
+  /** 一轮对话完成（无更多工具调用、命中 terminal 工具或达到 maxToolRounds 上限） */
   (e: 'finish', message: ChatMessage): void
   /** 对话出错 */
   (e: 'error', error: Error): void
@@ -43,14 +64,22 @@ export interface AiChatEmits {
 }
 
 export interface _AiChatExposed {
-  /** 发送一条用户消息 */
+  /** 发送一条用户消息（会话进行中时进入待发送队列） */
   send: (content: string, attachments?: ChatAttachment[]) => void
-  /** 中断当前生成 */
+  /** 中断当前生成（保留待发送队列） */
   abort: () => void
   /** 重新生成最后一条 assistant 回复 */
   regenerate: () => void
-  /** 清空消息 */
+  /** 清空消息与待发送队列 */
   clear: () => void
+  /** 待发送消息队列（会话进行中提交的消息按序排队，收尾后 FIFO 自动接续） */
+  queue: Ref<ChatQueuedMessage[]>
+  /** 立即执行队列中的某条：中断当前会话并插队为下一条 */
+  startQueued: (id: string) => void
+  /** 从队列移除某条（返回被移除项） */
+  removeQueued: (id: string) => ChatQueuedMessage | undefined
+  /** 向队列插入一条消息（beforeId 插到某条之前，缺省追加尾部；空闲时自动消耗队首） */
+  enqueue: (content: string, attachments?: ChatAttachment[], beforeId?: string) => ChatQueuedMessage
 }
 
 export type AiChatExposed = DeconstructValue<_AiChatExposed>

package/src/types/ai-orb.ts

@@ -0,0 +1,27 @@
+/** 活体球生命状态：驱动常态动画（平静 / 思考 / 输出） */
+export type AiOrbStatus = 'idle' | 'thinking' | 'speaking'
+
+/**
+ * 瞬时表情：播放约 1-2s 后自动回到 status 驱动的常态。
+ * - happy：成功 / 回答完毕 —— 先睁大眼睛，再弯眼大笑 + 点头
+ * - shock：惊讶 —— 睁大眼睛 + 小嘴微张 + 轻微后仰
+ * - frustrated：受挫（如工具调用失败）—— 闭紧眼睛 + 摇头 + 嘴角下撇
+ */
+export type AiOrbReaction = 'happy' | 'shock' | 'frustrated'
+
+export interface AiOrbProps {
+  /** 球体直径（px），默认 48 */
+  size?: number
+  /** 生命状态，默认 idle */
+  status?: AiOrbStatus
+}
+
+export interface AiOrbEmits {
+  /** 点击球体（球体同时会做 Q 弹反馈） */
+  (e: 'click'): void
+}
+
+export interface AiOrbExposed {
+  /** 播放一次瞬时表情（对应阶段性事件，如回答完毕 / 工具调用失败） */
+  react: (reaction: AiOrbReaction) => void
+}

package/src/types/index.ts

@@ -1 +1,2 @@
 export * from './ai-chat'
+export * from './ai-orb'

package/dist/components/ai-chat/ai-chat.vue.d.ts

@@ -1,36 +0,0 @@
-import { ChatMessage, ChatToolCall } from "../../chat/types.js";
-import { AiChatProps, _AiChatExposed } from "../../types/ai-chat.js";
-import "../../types/index.js";
-import "../../index.js";
-//#region src/components/ai-chat/ai-chat.vue.d.ts
-type __VLS_Slots = {
-  /** 空状态欢迎区插槽 */
-  welcome(): any;
-  /** 按工具名自定义工具结果展示，如 tool-getWeather */
-  [name: `tool-${string}`]: (scope: {
-    toolCall: ChatToolCall;
-  }) => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<AiChatProps, _AiChatExposed, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-  "update:messages": (messages: ChatMessage[]) => any;
-  send: (message: ChatMessage) => any;
-  finish: (message: ChatMessage) => any;
-  error: (error: Error) => any;
-  "tool-call": (toolCall: ChatToolCall) => any;
-}, string, import("vue").PublicProps, Readonly<AiChatProps> & Readonly<{
-  "onUpdate:messages"?: ((messages: ChatMessage[]) => any) | undefined;
-  onSend?: ((message: ChatMessage) => any) | undefined;
-  onFinish?: ((message: ChatMessage) => any) | undefined;
-  onError?: ((error: Error) => any) | undefined;
-  "onTool-call"?: ((toolCall: ChatToolCall) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-type __VLS_WithSlots<T, S> = T & {
-  new (): {
-    $slots: S;
-  };
-};
-//#endregion
-export { _default as default };
-//# sourceMappingURL=ai-chat.vue.d.ts.map

package/dist/components/ai-chat/index.d.ts

@@ -1,2 +0,0 @@
-import _default from "./ai-chat.vue.js";
-export { _default as UAiChat };

package/dist/components/index.d.ts

@@ -1,3 +0,0 @@
-import _default from "./ai-chat/ai-chat.vue.js";
-import "./ai-chat/index.js";
-export { _default as UAiChat };