@veltra/ai 2.1.7 → 2.1.9

package/dist/chat/fold.d.ts

@@ -3,7 +3,7 @@ import { AskQuestionItem } from "../tools/ask-question/ask-question.js";
 import "../tools/index.js";
 import { ChatSessionEvent } from "./session.js";
 //#region src/chat/fold.d.ts
-interface ChatPendingApproval {
+export interface ChatPendingApproval {
   approvalId: string;
   toolName: string;
   callId?: string;
@@ -11,7 +11,7 @@ interface ChatPendingApproval {
   rpcId: string;
 }
 /** 历史回放与实时 onEvent 共用的折叠状态 */
-interface ChatFoldState {
+export interface ChatFoldState {
   lastSeq: number | null;
   messages: ChatMessage[];
   queue: ChatQueuedMessage[];
@@ -30,12 +30,11 @@ interface ChatFoldState {
     message: string;
   } | null;
 }
-declare function createFoldState(): ChatFoldState;
+export declare function createFoldState(): ChatFoldState;
 /**
  * 纯函数 fold：历史回放与实时 onEvent 走同一套。
  * 后到的更小/重复 seq 不覆盖已应用事件。
  */
-declare function foldSessionEvent(state: ChatFoldState, event: ChatSessionEvent): ChatFoldState;
+export declare function foldSessionEvent(state: ChatFoldState, event: ChatSessionEvent): ChatFoldState;
 //#endregion
-export { ChatFoldState, ChatPendingApproval, createFoldState, foldSessionEvent };
 //# sourceMappingURL=fold.d.ts.map

package/dist/chat/session.d.ts

@@ -3,7 +3,7 @@ import { AskQuestionItem } from "../tools/ask-question/ask-question.js";
 import "../tools/index.js";
 //#region src/chat/session.d.ts
 /** 归一化后的服务端会话事件（协议无关） */
-type ChatSessionEvent = {
+export type ChatSessionEvent = {
   type: 'user/message';
   messageId: string;
   seq: number;
@@ -78,7 +78,7 @@ type ChatSessionEvent = {
   message: string;
 };
 /** 服务端会话 transport：对象形态，与函数型 ChatTransport 互斥 */
-interface ChatSessionTransport {
+export interface ChatSessionTransport {
   readonly kind: 'session';
   open(handlers: {
     onEvent(event: ChatSessionEvent): void;
@@ -97,7 +97,7 @@ interface ChatSessionTransport {
  * 协议翻译层：订阅事件流、把动作打到远端、拉历史。
  * 时序校验 / dispose / 断线补拉 / in-flight 去重由 createServerTransport 完成。
  */
-interface ChatSessionAdapter {
+export interface ChatSessionAdapter {
   subscribe(handlers: {
     onEvent(event: ChatSessionEvent): void;
     onDisconnect?(): void;
@@ -112,12 +112,11 @@ interface ChatSessionAdapter {
   selectModel(provider: string, model: string): Promise<void>;
 }
 /** 仅带 kind: 'session' 的对象为 true；函数 / null / 无 kind 均为 false */
-declare function isServerTransport(t: unknown): t is ChatSessionTransport;
+export declare function isServerTransport(t: unknown): t is ChatSessionTransport;
 /**
  * 用 adapter 包出 ChatSessionTransport。
  * 包内完成 seq 校验、disposer、断线补拉、动作 in-flight 去重。
  */
-declare function createServerTransport(adapter: ChatSessionAdapter): ChatSessionTransport;
+export declare function createServerTransport(adapter: ChatSessionAdapter): ChatSessionTransport;
 //#endregion
-export { ChatSessionAdapter, ChatSessionEvent, ChatSessionTransport, createServerTransport, isServerTransport };
 //# sourceMappingURL=session.d.ts.map

package/dist/chat/transports/openai.d.ts

@@ -2,7 +2,7 @@ import { ChatTransport } from "../types.js";
 import { ChatModelOption, ChatProvider } from "../../providers/types.js";
 //#region src/chat/transports/openai.d.ts
 /** createOpenAITransport 的配置项（多 Provider） */
-interface OpenAITransportOptions {
+export interface OpenAITransportOptions {
   /** 至少一个 Provider；模型 id 须跨 Provider 全局唯一 */
   providers: ChatProvider[];
   /** 全局额外请求头（与各 Provider headers 合并，Provider 优先） */
@@ -11,7 +11,7 @@ interface OpenAITransportOptions {
   body?: Record<string, unknown>;
 }
 /** 带扁平模型列表元数据的 OpenAI 兼容 transport */
-type OpenAITransport = ChatTransport & {
+export type OpenAITransport = ChatTransport & {
   /** 供 UI 使用的扁平模型列表 */
   readonly models: ChatModelOption[];
   /** 默认模型 id（首个 Provider 的首个模型） */
@@ -21,7 +21,6 @@ type OpenAITransport = ChatTransport & {
  * 创建 OpenAI 兼容协议的传输层（chat/completions SSE）。
  * 按 request.model 路由到对应 Provider 的 endpoint；手写 fetch + SSE，无第三方依赖。
  */
-declare function createOpenAITransport(options: OpenAITransportOptions): OpenAITransport;
+export declare function createOpenAITransport(options: OpenAITransportOptions): OpenAITransport;
 //#endregion
-export { OpenAITransport, OpenAITransportOptions, createOpenAITransport };
 //# sourceMappingURL=openai.d.ts.map

package/dist/chat/types.d.ts

@@ -1,7 +1,7 @@
 import { Component } from "vue";
 //#region src/chat/types.d.ts
 /** 聊天附件（首版仅支持图片） */
-interface ChatAttachment {
+export interface ChatAttachment {
   /** 文件名 */
   name: string;
   /** MIME 类型 */
@@ -12,9 +12,9 @@ interface ChatAttachment {
   dataUrl: string;
 }
 /** 工具调用状态 */
-type ToolCallStatus = 'pending' | 'awaiting-confirm' | 'running' | 'success' | 'error' | 'rejected';
+export type ToolCallStatus = 'pending' | 'awaiting-confirm' | 'running' | 'success' | 'error' | 'rejected';
 /** 一次工具调用 */
-interface ChatToolCall {
+export interface ChatToolCall {
   /** 调用 id（由模型生成） */
   id: string;
   /** 工具名 */
@@ -31,7 +31,7 @@ interface ChatToolCall {
   view?: unknown;
 }
 /** 聊天消息 */
-interface ChatMessage {
+export interface ChatMessage {
   /** 消息 id */
   id: string;
   /** 角色 */
@@ -50,7 +50,7 @@ interface ChatMessage {
   status?: 'streaming' | 'done' | 'error' | 'aborted';
 }
 /** 队列中的待发送消息（会话进行中提交的消息按序排队） */
-interface ChatQueuedMessage {
+export interface ChatQueuedMessage {
   /** 队列项 id */
   id: string;
   /** 消息内容 */
@@ -59,7 +59,7 @@ interface ChatQueuedMessage {
   attachments?: ChatAttachment[];
 }
 /** 工具执行上下文 */
-interface ChatToolContext {
+export interface ChatToolContext {
   /** 本次工具调用 */
   toolCall: ChatToolCall;
   /** 中断信号（用户点击停止时触发） */
@@ -69,7 +69,7 @@ interface ChatToolContext {
  * 对话工具定义。
  * 在不同场景传入不同的工具数组，即可赋予对话助手不同的能力。
  */
-interface ChatTool<A = any> {
+export interface ChatTool<A = any> {
   /** 工具名（传给模型，需唯一） */
   name: string;
   /** 工具描述（传给模型） */
@@ -122,7 +122,7 @@ interface ChatTool<A = any> {
  * 服务端驱动模式下 tools 的合法形态：纯渲染元信息（执行在服务端）。
  * 没有 execute / description / parameters / needsConfirm / terminal。
  */
-interface ChatToolMeta {
+export interface ChatToolMeta {
   /** 与服务端 tool/call.name 匹配 */
   name: string;
   /** 覆盖通用图标 */
@@ -141,9 +141,9 @@ interface ChatToolMeta {
   autoCollapse?: boolean;
 }
 /** 作业条项状态：至少区分进行中与终态 */
-type ChatJobStatus = 'running' | 'done' | 'error';
+export type ChatJobStatus = 'running' | 'done' | 'error';
 /** 服务端下发的作业条项 */
-interface ChatJob {
+export interface ChatJob {
   /** 稳定 id */
   id: string;
   /** 作业类型（用于图标映射） */
@@ -154,12 +154,12 @@ interface ChatJob {
   status: ChatJobStatus;
 }
 /** 工具自定义渲染组件 / 渲染函数的 props */
-interface ChatToolRenderProps {
+export interface ChatToolRenderProps {
   /** 本次工具调用（含 status/arguments/result/error，可自行渲染进度与错误） */
   toolCall: ChatToolCall;
 }
 /** transport 请求参数 */
-interface ChatTransportRequest {
+export interface ChatTransportRequest {
   /** 完整消息历史（内部模型，transport 自行转换为 wire 格式） */
   messages: ChatMessage[];
   /** 系统提示词 */
@@ -177,7 +177,7 @@ interface ChatTransportRequest {
  * 一次模型请求的 token 用量。
  * 仅包含接口实际返回的字段；缓存类数字缺省为 undefined，不补 0。
  */
-interface ChatTokenUsage {
+export interface ChatTokenUsage {
   /** 输入 token */
   promptTokens: number;
   /** 输出 token */
@@ -199,7 +199,7 @@ interface ChatTokenUsage {
   cacheCreationTokens?: number;
 }
 /** transport 流式事件回调 */
-interface ChatTransportHandlers {
+export interface ChatTransportHandlers {
   /** 文本增量 */
   onTextDelta(delta: string): void;
   /** 思考内容增量 */
@@ -225,7 +225,6 @@ interface ChatTransportHandlers {
  * 对话传输层抽象。组件不关心具体的 LLM 协议，
  * 可传入内置的 createOpenAITransport()，也可自行实现接入任意后端。
  */
-type ChatTransport = (request: ChatTransportRequest, handlers: ChatTransportHandlers) => Promise<void> | void;
+export type ChatTransport = (request: ChatTransportRequest, handlers: ChatTransportHandlers) => Promise<void> | void;
 //#endregion
-export { ChatAttachment, ChatJob, ChatJobStatus, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolMeta, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus };
 //# sourceMappingURL=types.d.ts.map

package/dist/chat/use-chat.d.ts

@@ -6,7 +6,7 @@ import "../types/index.js";
 import { ChatPendingApproval } from "./fold.js";
 import { Ref } from "vue";
 //#region src/chat/use-chat.d.ts
-interface UseChatOptions {
+export interface UseChatOptions {
   props: AiChatProps;
   emit: AiChatEmits;
 }
@@ -15,7 +15,7 @@ interface UseChatOptions {
  * 与 UI 解耦，ai-chat.vue 只负责渲染与交互转发。
  * 函数型 transport 注入内置工具；session transport 不注入、不执行客户端工具。
  */
-declare function useChat(options: UseChatOptions): {
+export declare function useChat(options: UseChatOptions): {
   messages: Ref<ChatMessage[], ChatMessage[]>;
   model: Ref<string | undefined, string | undefined>;
   reasoningLevel: Ref<string | undefined, string | undefined>;
@@ -124,5 +124,4 @@ declare function useChat(options: UseChatOptions): {
   removeQueued: (id: string) => ChatQueuedMessage | undefined;
 };
 //#endregion
-export { UseChatOptions, useChat };
 //# sourceMappingURL=use-chat.d.ts.map

package/dist/components/ai-chat/style2.css

@@ -173,6 +173,8 @@
   max-width: 800px;
   display: flex;
   flex-direction: column;
+  padding: var(--u-gap-default) 0;
+  box-sizing: border-box;
 }
 .u-ai-chat__list {
   flex: 1;

package/dist/providers/types.d.ts

@@ -1,13 +1,13 @@
 //#region src/providers/types.d.ts
 /** 推理等级选项（值不透明，由宿主/服务商约定） */
-interface ChatReasoningLevel {
+export interface ChatReasoningLevel {
   /** 写入请求的值 */
   value: string;
   /** UI 文案 */
   label: string;
 }
 /** 单个模型配置 */
-interface ChatModel {
+export interface ChatModel {
   /** 模型 id（跨 Provider 全局唯一） */
   id: string;
   /** UI 显示名，缺省取 id */
@@ -20,7 +20,7 @@ interface ChatModel {
   defaultReasoningLevel?: string;
 }
 /** 模型服务商配置（内嵌 models） */
-interface ChatProvider {
+export interface ChatProvider {
   id: string;
   /** UI 显示名 */
   label?: string;
@@ -38,10 +38,9 @@ interface ChatProvider {
   models: ChatModel[];
 }
 /** UI / useChat 使用的扁平模型项（带 providerId） */
-interface ChatModelOption extends ChatModel {
+export interface ChatModelOption extends ChatModel {
   providerId: string;
   providerLabel?: string;
 }
 //#endregion
-export { ChatModel, ChatModelOption, ChatProvider, ChatReasoningLevel };
 //# sourceMappingURL=types.d.ts.map

package/dist/tools/ask-question/ask-question.d.ts

@@ -2,7 +2,7 @@ import "../../chat/types.js";
 import { Component } from "vue";
 //#region src/tools/ask-question/ask-question.d.ts
 /** 单个提问项 */
-interface AskQuestionItem {
+export interface AskQuestionItem {
   /** 问题文案 */
   question: string;
   /** 预设选项（单选）；缺省为纯文本题 */
@@ -11,20 +11,19 @@ interface AskQuestionItem {
   placeholder?: string;
 }
 /** 一条问答结果 */
-interface AskQuestionAnswer {
+export interface AskQuestionAnswer {
   /** 问题文案 */
   question: string;
   /** 用户回答（选中的选项或自定义输入） */
   answer: string;
 }
 /** 提问工具参数（模型输出） */
-interface AskQuestionArgs {
+export interface AskQuestionArgs {
   questions: AskQuestionItem[];
 }
 /** 提问工具结果（序列化后回灌模型，渲染层据此展示问答摘要） */
-interface AskQuestionResult {
+export interface AskQuestionResult {
   answers: AskQuestionAnswer[];
 }
 //#endregion
-export { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult };
 //# sourceMappingURL=ask-question.d.ts.map

package/dist/types/ai-chat.d.ts

@@ -4,7 +4,7 @@ import { ChatModelOption } from "../providers/types.js";
 import { Component, Ref } from "vue";
 import { DeconstructValue } from "@veltra/utils";
 //#region src/types/ai-chat.d.ts
-interface AiChatProps {
+export interface AiChatProps {
   /** 传输层（必填）；函数型 ChatTransport 或 session 对象，可使用 createOpenAITransport / createServerTransport */
   transport: ChatTransport | ChatSessionTransport;
   /**
@@ -53,7 +53,7 @@ interface AiChatProps {
   /** 只读：不展示输入区、欢迎语不可发送、队列无插队/编辑/移除。默认 false */
   readonly?: boolean;
 }
-interface AiChatEmits {
+export interface AiChatEmits {
   /** 消息列表变化 */
   (e: 'update:messages', messages: ChatMessage[]): void;
   /** 当前模型变化 */
@@ -69,7 +69,7 @@ interface AiChatEmits {
   /** 模型发起工具调用 */
   (e: 'tool-call', toolCall: ChatToolCall): void;
 }
-interface _AiChatExposed {
+export interface _AiChatExposed {
   /** 发送一条用户消息（会话进行中时进入待发送队列） */
   send: (content: string, attachments?: ChatAttachment[]) => void;
   /** 中断当前生成（保留待发送队列） */
@@ -91,7 +91,6 @@ interface _AiChatExposed {
   /** 向队列插入一条消息（beforeId 插到某条之前，缺省追加尾部；空闲时自动消耗队首） */
   enqueue: (content: string, attachments?: ChatAttachment[], beforeId?: string) => ChatQueuedMessage;
 }
-type AiChatExposed = DeconstructValue<_AiChatExposed>;
+export type AiChatExposed = DeconstructValue<_AiChatExposed>;
 //#endregion
-export { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed };
 //# sourceMappingURL=ai-chat.d.ts.map

package/dist/types/ai-orb.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/ai",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"
@@ -36,14 +36,14 @@
     }
   },
   "dependencies": {
-    "markstream-vue": "^2.0.7"
+    "markstream-vue": "^2.0.11"
   },
   "peerDependencies": {
-    "@veltra/compositions": "^1.7.4",
-    "@veltra/desktop": "^1.7.4",
+    "@veltra/compositions": "^1.7.14",
+    "@veltra/desktop": "^1.7.14",
     "@veltra/icons": "^1.5.0",
-    "@veltra/styles": "^1.7.4",
-    "@veltra/utils": "^1.7.4",
+    "@veltra/styles": "^1.7.14",
+    "@veltra/utils": "^1.7.14",
     "vue": ">=3.5.42"
   }
 }

package/src/components/ai-chat/style.scss

@@ -186,6 +186,9 @@ $root-name: ai-chat;
     max-width: 800px;
     display: flex;
     flex-direction: column;
+    // 纵向留出呼吸位：首条消息不贴容器顶，滚动时内容不顶边；横向由各消息自身 padding 控制
+    padding: fn.use-var(gap, default) 0;
+    box-sizing: border-box;
   }
 
   @include m.e(list) {