@veltra/ai 1.4.0

package/dist/components/ai-chat/tool-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.js","names":[],"sources":["../../../src/components/ai-chat/tool-call.vue"],"sourcesContent":["<template>\n  <div :class=\"[cls.e('tool-call'), bem.is(toolCall.status), bem.is('expanded', isExpanded)]\">\n    <UCollapseItem v-model=\"isExpanded\" @change=\"markUserToggled\">\n      <template #title>\n        <UIcon :class=\"[cls.e('tool-call-status'), statusClass]\">\n          <component :is=\"headerIcon\" />\n        </UIcon>\n        <span :class=\"cls.e('tool-call-name')\">{{ tool?.label ?? toolCall.name }}</span>\n        <span v-if=\"summary\" :class=\"cls.e('tool-call-summary')\">{{ summary }}</span>\n\n        <span\n          v-if=\"toolCall.status === 'awaiting-confirm'\"\n          :class=\"cls.e('tool-call-confirm')\"\n          @click.stop\n        >\n          <UButton size=\"small\" type=\"primary\" @click=\"emit('respond', true)\">允许</UButton>\n          <UButton size=\"small\" text @click=\"emit('respond', false)\">拒绝</UButton>\n        </span>\n      </template>\n\n      <!-- 自定义渲染：工具定义的 render 优先于 tool-<name> 插槽，均替换整个 body -->\n      <component :is=\"tool?.render\" v-if=\"tool?.render\" :tool-call=\"toolCall\" />\n      <component :is=\"slotBody\" v-else-if=\"slotBody && hasResult\" />\n      <template v-else>\n        <template v-if=\"prettyArguments\">\n          <div :class=\"cls.e('tool-call-section')\">参数</div>\n          <pre :class=\"cls.e('tool-call-code')\">{{ prettyArguments }}</pre>\n        </template>\n\n        <template v-if=\"hasResult\">\n          <div :class=\"cls.e('tool-call-section')\">\n            {{ toolCall.status === 'error' ? '错误' : '结果' }}\n          </div>\n          <pre :class=\"cls.e('tool-call-code')\">{{ displayResult }}</pre>\n        </template>\n      </template>\n    </UCollapseItem>\n  </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UButton, UCollapseItem, UIcon } from '@veltra/desktop'\nimport '@veltra/desktop/components/collapse/style'\nimport { CircleCheckFilled, CircleClose, Close, Loading, WarningFilled } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { computed, inject, ref, watch, type Component } from 'vue'\n\nimport type { ChatToolCall } from '../../chat/types'\nimport { AiChatDIKey } from './di'\n\ndefineOptions({ name: 'UAiChatToolCall' })\n\nconst props = defineProps<{ toolCall: ChatToolCall }>()\n\nconst emit = defineEmits<{ (e: 'respond', approved: boolean): void }>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\n/** 当前调用对应的工具定义（解析 icon/label/render/autoCollapse） */\nconst tool = computed(() => di?.tools.value[props.toolCall.name])\n\nconst isExpanded = ref(false)\n/** 用户手动切换过后，不再随 status 自动展开/折叠 */\nlet userToggled: boolean = false\n\nfunction markUserToggled() {\n  userToggled = true\n}\n\n/** 完成后是否自动折叠：缺省有 render 时不折叠，否则折叠 */\nconst autoCollapse = computed(() => tool.value?.autoCollapse ?? !tool.value?.render)\n\nwatch(\n  () => props.toolCall.status,\n  (status) => {\n    if (userToggled) return\n    if (status === 'running' || status === 'awaiting-confirm') {\n      isExpanded.value = true\n    } else {\n      isExpanded.value = !autoCollapse.value\n    }\n  },\n  { immediate: true }\n)\n\nconst STATUS_META: Record<string, { icon: Component; class: string }> = {\n  pending: { icon: Loading, class: 'is-loading' },\n  running: { icon: Loading, class: 'is-loading' },\n  'awaiting-confirm': { icon: WarningFilled, class: 'is-warning' },\n  success: { icon: CircleCheckFilled, class: 'is-success' },\n  error: { icon: CircleClose, class: 'is-danger' },\n  rejected: { icon: Close, class: 'is-danger' }\n}\n\nconst statusIcon = computed(() => STATUS_META[props.toolCall.status]?.icon ?? Loading)\nconst statusClass = computed(() => STATUS_META[props.toolCall.status]?.class ?? '')\n\n/** 头部图标：工具自定义图标优先，缺省用状态图标 */\nconst headerIcon = computed(() => tool.value?.icon ?? statusIcon.value)\n\nconst parsedArguments = computed<Record<string, unknown> | null>(() => {\n  if (!props.toolCall.arguments) return null\n  try {\n    return JSON.parse(props.toolCall.arguments)\n  } catch {\n    return null\n  }\n})\n\n/** 折叠态参数摘要：取第一个字符串参数值 */\nconst summary = computed(() => {\n  const args = parsedArguments.value\n  if (!args) return ''\n  for (const value of Object.values(args)) {\n    if (typeof value === 'string' && value) {\n      return value.length > 40 ? `${value.slice(0, 40)}…` : value\n    }\n  }\n  return ''\n})\n\nconst prettyArguments = computed(() => {\n  const args = parsedArguments.value\n  if (args) return JSON.stringify(args, null, 2)\n  return props.toolCall.arguments || ''\n})\n\nconst hasResult = computed(() => {\n  return props.toolCall.result != null || props.toolCall.error != null\n})\n\nconst displayResult = computed(() => {\n  const raw = props.toolCall.error ?? props.toolCall.result ?? ''\n  try {\n    return JSON.stringify(JSON.parse(raw), null, 2)\n  } catch {\n    return raw\n  }\n})\n\n/** 使用方通过 tool-<name> 插槽自定义该工具的展示（有结果时替换整个 body） */\nconst slotBody = computed(() => {\n  const slot = di?.slots[`tool-${props.toolCall.name}`]\n  return slot ? () => slot({ toolCall: props.toolCall }) : undefined\n})\n</script>\n"],"mappings":";;;;;;;;;;;;;EAoDA,MAAM,QAAQ;EAEd,MAAM,OAAO;EAEb,MAAM,KAAK,OAAO,WAAW;EAC7B,MAAM,MAAM,IAAI,OAAO,IAAI,SAAS;;EAGpC,MAAM,OAAO,eAAe,IAAI,MAAM,MAAM,MAAM,SAAS,KAAK;EAEhE,MAAM,aAAa,IAAI,KAAK;;EAE5B,IAAI,cAAuB;EAE3B,SAAS,kBAAkB;GACzB,cAAc;EAChB;;EAGA,MAAM,eAAe,eAAe,KAAK,OAAO,gBAAgB,CAAC,KAAK,OAAO,MAAM;EAEnF,YACQ,MAAM,SAAS,SACpB,WAAW;GACV,IAAI,aAAa;GACjB,IAAI,WAAW,aAAa,WAAW,oBACrC,WAAW,QAAQ;QAEnB,WAAW,QAAQ,CAAC,aAAa;EAErC,GACA,EAAE,WAAW,KAAK,CACpB;EAEA,MAAM,cAAkE;GACtE,SAAS;IAAE,MAAM;IAAS,OAAO;GAAa;GAC9C,SAAS;IAAE,MAAM;IAAS,OAAO;GAAa;GAC9C,oBAAoB;IAAE,MAAM;IAAe,OAAO;GAAa;GAC/D,SAAS;IAAE,MAAM;IAAmB,OAAO;GAAa;GACxD,OAAO;IAAE,MAAM;IAAa,OAAO;GAAY;GAC/C,UAAU;IAAE,MAAM;IAAO,OAAO;GAAY;EAC9C;EAEA,MAAM,aAAa,eAAe,YAAY,MAAM,SAAS,OAAO,EAAE,QAAQ,OAAO;EACrF,MAAM,cAAc,eAAe,YAAY,MAAM,SAAS,OAAO,EAAE,SAAS,EAAE;;EAGlF,MAAM,aAAa,eAAe,KAAK,OAAO,QAAQ,WAAW,KAAK;EAEtE,MAAM,kBAAkB,eAA+C;GACrE,IAAI,CAAC,MAAM,SAAS,WAAW,OAAO;GACtC,IAAI;IACF,OAAO,KAAK,MAAM,MAAM,SAAS,SAAS;GAC5C,QAAQ;IACN,OAAO;GACT;EACF,CAAC;;EAGD,MAAM,UAAU,eAAe;GAC7B,MAAM,OAAO,gBAAgB;GAC7B,IAAI,CAAC,MAAM,OAAO;GAClB,KAAK,MAAM,SAAS,OAAO,OAAO,IAAI,GACpC,IAAI,OAAO,UAAU,YAAY,OAC/B,OAAO,MAAM,SAAS,KAAK,GAAG,MAAM,MAAM,GAAG,EAAE,EAAE,KAAK;GAG1D,OAAO;EACT,CAAC;EAED,MAAM,kBAAkB,eAAe;GACrC,MAAM,OAAO,gBAAgB;GAC7B,IAAI,MAAM,OAAO,KAAK,UAAU,MAAM,MAAM,CAAC;GAC7C,OAAO,MAAM,SAAS,aAAa;EACrC,CAAC;EAED,MAAM,YAAY,eAAe;GAC/B,OAAO,MAAM,SAAS,UAAU,QAAQ,MAAM,SAAS,SAAS;EAClE,CAAC;EAED,MAAM,gBAAgB,eAAe;GACnC,MAAM,MAAM,MAAM,SAAS,SAAS,MAAM,SAAS,UAAU;GAC7D,IAAI;IACF,OAAO,KAAK,UAAU,KAAK,MAAM,GAAG,GAAG,MAAM,CAAC;GAChD,QAAQ;IACN,OAAO;GACT;EACF,CAAC;;EAGD,MAAM,WAAW,eAAe;GAC9B,MAAM,OAAO,IAAI,MAAM,QAAQ,MAAM,SAAS;GAC9C,OAAO,aAAa,KAAK,EAAE,UAAU,MAAM,SAAS,CAAC,IAAI,KAAA;EAC3D,CAAC;;uBAhJC,mBAoCM,OAAA,EApCA,OAAK,eAAA;IAAG,MAAA,GAAA,CAAG,CAAC,EAAC,WAAA;IAAe,MAAA,GAAA,CAAG,CAAC,GAAG,QAAA,SAAS,MAAM;IAAG,MAAA,GAAA,CAAG,CAAC,GAAE,YAAa,WAAA,KAAU;GAAA,CAAA,EAAA,GAAA,CACtF,YAkCgB,MAAA,aAAA,GAAA;gBAlCQ,WAAA;iEAAA,WAAU,QAAA;IAAG,UAAQ;;IAChC,OAAK,cAGN;KAFR,YAEQ,MAAA,KAAA,GAAA,EAFA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,kBAAA,GAAsB,YAAA,KAAW,CAAA,EAAA,GAAA;6BACtB,EAAA,UAAA,GAA9B,YAA8B,wBAAd,WAAA,KAAU,CAAA,EAAA,CAAA;;;KAE5B,mBAAgF,QAAA,EAAzE,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAA,GAAA,gBAAuB,KAAA,OAAM,SAAS,QAAA,SAAS,IAAI,GAAA,CAAA;KAC1D,QAAA,SAAA,UAAA,GAAZ,mBAA6E,QAAA;;MAAvD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA;wBAA0B,QAAA,KAAO,GAAA,CAAA,KAAA,mBAAA,QAAA,IAAA;KAG3D,QAAA,SAAS,WAAM,sBAAA,UAAA,GADvB,mBAOO,QAAA;;MALJ,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA;MACZ,SAAK,OAAA,OAAA,OAAA,KAAA,oBAAN,CAAA,GAAW,CAAA,MAAA,CAAA;SAEX,YAAgF,MAAA,OAAA,GAAA;MAAvE,MAAK;MAAQ,MAAK;MAAW,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,WAAA,IAAA;;6BAAqB,CAAA,GAAA,OAAA,OAAA,OAAA,KAAA,CAAA,gBAAF,MAAE,EAAA,CAAA,EAAA,CAAA;;SACtE,YAAuE,MAAA,OAAA,GAAA;MAA9D,MAAK;MAAQ,MAAA;MAAM,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,WAAA,KAAA;;6BAAsB,CAAA,GAAA,OAAA,OAAA,OAAA,KAAA,CAAA,gBAAF,MAAE,EAAA,CAAA,EAAA,CAAA;;;;2BAKS,CAAtC,KAAA,OAAM,UAAA,UAAA,GAA1C,YAA0E,wBAA1D,KAAA,OAAM,MAAM,GAAA;;KAAuB,aAAW,QAAA;kCACzB,SAAA,SAAY,UAAA,SAAA,UAAA,GAAjD,YAA8D,wBAA9C,SAAA,KAAQ,GAAA,EAAA,KAAA,EAAA,CAAA,MAAA,UAAA,GACxB,mBAYW,UAAA,EAAA,KAAA,EAAA,GAAA,CAXO,gBAAA,SAAA,UAAA,GAAhB,mBAGW,UAAA,EAAA,KAAA,EAAA,GAAA,CAFT,mBAAiD,OAAA,EAA3C,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA,EAAA,GAAuB,MAAE,CAAA,GAC3C,mBAAiE,OAAA,EAA3D,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAA,GAAA,gBAAuB,gBAAA,KAAe,GAAA,CAAA,CAAA,GAAA,EAAA,KAAA,mBAAA,QAAA,IAAA,GAG1C,UAAA,SAAA,UAAA,GAAhB,mBAKW,UAAA,EAAA,KAAA,EAAA,GAAA,CAJT,mBAEM,OAAA,EAFA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA,EAAA,GAAA,gBACb,QAAA,SAAS,WAAM,UAAA,OAAA,IAAA,GAAA,CAAA,GAEpB,mBAA+D,OAAA,EAAzD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAA,GAAA,gBAAuB,cAAA,KAAa,GAAA,CAAA,CAAA,GAAA,EAAA,KAAA,mBAAA,QAAA,IAAA,CAAA,GAAA,EAAA,EAAA,CAAA"}

package/dist/components/index.d.ts

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { ChatAttachment, ChatMessage, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus } from "./chat/types.js";
+import { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed } from "./types/ai-chat.js";
+import "./types/index.js";
+import { UseChatOptions, useChat } from "./chat/use-chat.js";
+import { OpenAITransportOptions, createOpenAITransport } from "./chat/transports/openai.js";
+import "./chat/index.js";
+import _default from "./components/ai-chat/ai-chat.vue.js";
+import "./components/index.js";
+import { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool } from "./tools/ask-question/ask-question.js";
+import "./tools/index.js";
+export { type AiChatEmits, type AiChatExposed, type AiChatProps, AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, ChatAttachment, ChatMessage, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, CreateAskQuestionToolOptions, OpenAITransportOptions, ToolCallStatus, _default as UAiChat, UseChatOptions, type _AiChatExposed, createAskQuestionTool, createOpenAITransport, useChat };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { useChat } from "./chat/use-chat.js";
+import { createOpenAITransport } from "./chat/transports/openai.js";
+import _sfc_main from "./components/ai-chat/ai-chat.js";
+import { createAskQuestionTool } from "./tools/ask-question/ask-question.js";
+export { _sfc_main as UAiChat, createAskQuestionTool, createOpenAITransport, useChat };

package/dist/style.d.ts

@@ -0,0 +1 @@
+import "./components/ai-chat/style.js";

package/dist/style.js

@@ -0,0 +1 @@
+import "./components/ai-chat/style.js";

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

@@ -0,0 +1,45 @@
+import { ChatTool } from "../../chat/types.js";
+import { Component } from "vue";
+//#region src/tools/ask-question/ask-question.d.ts
+/** 单个提问项 */
+interface AskQuestionItem {
+  /** 问题文案 */
+  question: string;
+  /** 预设选项（单选）；缺省为纯文本题 */
+  options?: string[];
+  /** 自定义输入占位文案 */
+  placeholder?: string;
+}
+/** 一条问答结果 */
+interface AskQuestionAnswer {
+  /** 问题文案 */
+  question: string;
+  /** 用户回答（选中的选项或自定义输入） */
+  answer: string;
+}
+/** 提问工具参数（模型输出） */
+interface AskQuestionArgs {
+  questions: AskQuestionItem[];
+}
+/** 提问工具结果（序列化后回灌模型，渲染层据此展示问答摘要） */
+interface AskQuestionResult {
+  answers: AskQuestionAnswer[];
+}
+interface CreateAskQuestionToolOptions {
+  /** 工具名（传给模型），默认 askQuestion */
+  name?: string;
+  /** 工具描述（传给模型） */
+  description?: string;
+  /** 工具显示名，默认「提问」 */
+  label?: string;
+  /** 工具图标，默认 QuestionFilled */
+  icon?: Component;
+}
+/**
+ * 创建内置提问工具：execute 挂起等待用户在 UI 中作答，提交后结果回灌模型。
+ * 工具卡片由内联提问表单渲染（多题分页导航，提交后展示问答摘要，不自动折叠）。
+ */
+declare function createAskQuestionTool(options?: CreateAskQuestionToolOptions): ChatTool<AskQuestionArgs>;
+//#endregion
+export { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool };
+//# sourceMappingURL=ask-question.d.ts.map

package/dist/tools/ask-question/ask-question.js

@@ -0,0 +1,65 @@
+import { deferAskQuestion, takeAskQuestionDeferred } from "./deferred.js";
+import _sfc_main from "../../components/ai-chat/ask-question.js";
+import { QuestionFilled } from "@veltra/icons/normal";
+//#region src/tools/ask-question/ask-question.ts
+const DEFAULT_DESCRIPTION = "当需求不明确或存在歧义时，向用户提问以澄清。一次可提 1-4 个关键问题；每个问题可提供若干预设选项，用户可选择选项或自定义输入。用户作答后再继续生成。";
+/** 提问参数 JSON Schema（原样传给模型） */
+const QUESTIONS_SCHEMA = {
+	type: "object",
+	properties: { questions: {
+		type: "array",
+		description: "问题列表",
+		minItems: 1,
+		maxItems: 4,
+		items: {
+			type: "object",
+			properties: {
+				question: {
+					type: "string",
+					description: "问题文案"
+				},
+				options: {
+					type: "array",
+					description: "预设选项（单选）；缺省为纯文本题",
+					items: { type: "string" }
+				},
+				placeholder: {
+					type: "string",
+					description: "自定义输入占位文案"
+				}
+			},
+			required: ["question"]
+		}
+	} },
+	required: ["questions"]
+};
+/**
+* 创建内置提问工具：execute 挂起等待用户在 UI 中作答，提交后结果回灌模型。
+* 工具卡片由内联提问表单渲染（多题分页导航，提交后展示问答摘要，不自动折叠）。
+*/
+function createAskQuestionTool(options = {}) {
+	const { name = "askQuestion", description = DEFAULT_DESCRIPTION, label = "提问", icon = QuestionFilled } = options;
+	return {
+		name,
+		description,
+		parameters: QUESTIONS_SCHEMA,
+		icon,
+		label,
+		render: _sfc_main,
+		execute: (_args, { toolCall, signal }) => new Promise((resolve, reject) => {
+			deferAskQuestion(toolCall.id, {
+				resolve,
+				reject
+			});
+			signal.addEventListener("abort", () => {
+				const error = /* @__PURE__ */ new Error("Aborted");
+				error.name = "AbortError";
+				takeAskQuestionDeferred(toolCall.id)?.reject(error);
+			}, { once: true });
+		})
+	};
+}
+//#endregion
+export { createAskQuestionTool };
+
+//# sourceMappingURL=ask-question.js.map

package/dist/tools/ask-question/ask-question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-question.js","names":["AskQuestion"],"sources":["../../../src/tools/ask-question/ask-question.ts"],"sourcesContent":["import { QuestionFilled } from '@veltra/icons/normal'\nimport type { Component } from 'vue'\n\nimport type { ChatTool } from '../../chat/types'\nimport AskQuestion from '../../components/ai-chat/ask-question.vue'\nimport { deferAskQuestion, takeAskQuestionDeferred } from './deferred'\n\n/** 单个提问项 */\nexport interface AskQuestionItem {\n  /** 问题文案 */\n  question: string\n  /** 预设选项（单选）；缺省为纯文本题 */\n  options?: string[]\n  /** 自定义输入占位文案 */\n  placeholder?: string\n}\n\n/** 一条问答结果 */\nexport interface AskQuestionAnswer {\n  /** 问题文案 */\n  question: string\n  /** 用户回答（选中的选项或自定义输入） */\n  answer: string\n}\n\n/** 提问工具参数（模型输出） */\nexport interface AskQuestionArgs {\n  questions: AskQuestionItem[]\n}\n\n/** 提问工具结果（序列化后回灌模型，渲染层据此展示问答摘要） */\nexport interface AskQuestionResult {\n  answers: AskQuestionAnswer[]\n}\n\nexport interface CreateAskQuestionToolOptions {\n  /** 工具名（传给模型），默认 askQuestion */\n  name?: string\n  /** 工具描述（传给模型） */\n  description?: string\n  /** 工具显示名，默认「提问」 */\n  label?: string\n  /** 工具图标，默认 QuestionFilled */\n  icon?: Component\n}\n\nconst DEFAULT_DESCRIPTION =\n  '当需求不明确或存在歧义时，向用户提问以澄清。一次可提 1-4 个关键问题；' +\n  '每个问题可提供若干预设选项，用户可选择选项或自定义输入。用户作答后再继续生成。'\n\n/** 提问参数 JSON Schema（原样传给模型） */\nconst QUESTIONS_SCHEMA: Record<string, unknown> = {\n  type: 'object',\n  properties: {\n    questions: {\n      type: 'array',\n      description: '问题列表',\n      minItems: 1,\n      maxItems: 4,\n      items: {\n        type: 'object',\n        properties: {\n          question: { type: 'string', description: '问题文案' },\n          options: {\n            type: 'array',\n            description: '预设选项（单选）；缺省为纯文本题',\n            items: { type: 'string' }\n          },\n          placeholder: { type: 'string', description: '自定义输入占位文案' }\n        },\n        required: ['question']\n      }\n    }\n  },\n  required: ['questions']\n}\n\n/**\n * 创建内置提问工具：execute 挂起等待用户在 UI 中作答，提交后结果回灌模型。\n * 工具卡片由内联提问表单渲染（多题分页导航，提交后展示问答摘要，不自动折叠）。\n */\nexport function createAskQuestionTool(\n  options: CreateAskQuestionToolOptions = {}\n): ChatTool<AskQuestionArgs> {\n  const {\n    name = 'askQuestion',\n    description = DEFAULT_DESCRIPTION,\n    label = '提问',\n    icon = QuestionFilled\n  } = options\n\n  return {\n    name,\n    description,\n    parameters: QUESTIONS_SCHEMA,\n    icon,\n    label,\n    render: AskQuestion,\n    execute: (_args, { toolCall, signal }) =>\n      new Promise<AskQuestionResult>((resolve, reject) => {\n        deferAskQuestion(toolCall.id, { resolve, reject })\n        signal.addEventListener(\n          'abort',\n          () => {\n            // 不依赖 signal.reason（各环境 DOMException 行为不一），统一拒绝为 AbortError\n            const error = new Error('Aborted')\n            error.name = 'AbortError'\n            takeAskQuestionDeferred(toolCall.id)?.reject(error)\n          },\n          { once: true }\n        )\n      })\n  }\n}\n"],"mappings":";;;;AA8CA,MAAM,sBACJ;;AAIF,MAAM,mBAA4C;CAChD,MAAM;CACN,YAAY,EACV,WAAW;EACT,MAAM;EACN,aAAa;EACb,UAAU;EACV,UAAU;EACV,OAAO;GACL,MAAM;GACN,YAAY;IACV,UAAU;KAAE,MAAM;KAAU,aAAa;IAAO;IAChD,SAAS;KACP,MAAM;KACN,aAAa;KACb,OAAO,EAAE,MAAM,SAAS;IAC1B;IACA,aAAa;KAAE,MAAM;KAAU,aAAa;IAAY;GAC1D;GACA,UAAU,CAAC,UAAU;EACvB;CACF,EACF;CACA,UAAU,CAAC,WAAW;AACxB;;;;;AAMA,SAAgB,sBACd,UAAwC,CAAC,GACd;CAC3B,MAAM,EACJ,OAAO,eACP,cAAc,qBACd,QAAQ,MACR,OAAO,mBACL;CAEJ,OAAO;EACL;EACA;EACA,YAAY;EACZ;EACA;EACA,QAAQA;EACR,UAAU,OAAO,EAAE,UAAU,aAC3B,IAAI,SAA4B,SAAS,WAAW;GAClD,iBAAiB,SAAS,IAAI;IAAE;IAAS;GAAO,CAAC;GACjD,OAAO,iBACL,eACM;IAEJ,MAAM,wBAAQ,IAAI,MAAM,SAAS;IACjC,MAAM,OAAO;IACb,wBAAwB,SAAS,EAAE,CAAC,EAAE,OAAO,KAAK;GACpD,GACA,EAAE,MAAM,KAAK,CACf;EACF,CAAC;CACL;AACF"}

package/dist/tools/ask-question/deferred.js

@@ -0,0 +1,22 @@
+//#region src/tools/ask-question/deferred.ts
+/** 挂起的提问 Promise，key 为 toolCallId */
+const pending = /* @__PURE__ */ new Map();
+/** 注册挂起的提问 Promise（由 createAskQuestionTool 的 execute 调用） */
+function deferAskQuestion(toolCallId, deferred) {
+	pending.set(toolCallId, deferred);
+}
+/** 取出并移除挂起项（abort 监听用）；不存在则返回 undefined */
+function takeAskQuestionDeferred(toolCallId) {
+	const deferred = pending.get(toolCallId);
+	if (!deferred) return void 0;
+	pending.delete(toolCallId);
+	return deferred;
+}
+/** 兑现挂起的提问 Promise（由提问表单在用户提交时调用） */
+function resolveAskQuestion(toolCallId, result) {
+	takeAskQuestionDeferred(toolCallId)?.resolve(result);
+}
+//#endregion
+export { deferAskQuestion, resolveAskQuestion, takeAskQuestionDeferred };
+
+//# sourceMappingURL=deferred.js.map

package/dist/tools/ask-question/deferred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred.js","names":[],"sources":["../../../src/tools/ask-question/deferred.ts"],"sourcesContent":["import type { AskQuestionResult } from './ask-question'\n\ninterface AskQuestionDeferred {\n  resolve: (result: AskQuestionResult) => void\n  reject: (reason?: unknown) => void\n}\n\n/** 挂起的提问 Promise，key 为 toolCallId */\nconst pending = new Map<string, AskQuestionDeferred>()\n\n/** 注册挂起的提问 Promise（由 createAskQuestionTool 的 execute 调用） */\nexport function deferAskQuestion(toolCallId: string, deferred: AskQuestionDeferred): void {\n  pending.set(toolCallId, deferred)\n}\n\n/** 取出并移除挂起项（abort 监听用）；不存在则返回 undefined */\nexport function takeAskQuestionDeferred(toolCallId: string): AskQuestionDeferred | undefined {\n  const deferred = pending.get(toolCallId)\n  if (!deferred) return undefined\n  pending.delete(toolCallId)\n  return deferred\n}\n\n/** 兑现挂起的提问 Promise（由提问表单在用户提交时调用） */\nexport function resolveAskQuestion(toolCallId: string, result: AskQuestionResult): void {\n  takeAskQuestionDeferred(toolCallId)?.resolve(result)\n}\n"],"mappings":";;AAQA,MAAM,0BAAU,IAAI,IAAiC;;AAGrD,SAAgB,iBAAiB,YAAoB,UAAqC;CACxF,QAAQ,IAAI,YAAY,QAAQ;AAClC;;AAGA,SAAgB,wBAAwB,YAAqD;CAC3F,MAAM,WAAW,QAAQ,IAAI,UAAU;CACvC,IAAI,CAAC,UAAU,OAAO,KAAA;CACtB,QAAQ,OAAO,UAAU;CACzB,OAAO;AACT;;AAGA,SAAgB,mBAAmB,YAAoB,QAAiC;CACtF,wBAAwB,UAAU,CAAC,EAAE,QAAQ,MAAM;AACrD"}

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

@@ -0,0 +1,2 @@
+import { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool } from "./ask-question.js";
+export { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool };

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool } from "./ask-question/ask-question.js";
+import "./ask-question/index.js";
+export { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult, CreateAskQuestionToolOptions, createAskQuestionTool };

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

@@ -0,0 +1,49 @@
+import { ChatAttachment, ChatMessage, ChatTool, ChatToolCall, ChatTransport } from "../chat/types.js";
+import { DeconstructValue } from "@veltra/utils";
+//#region src/types/ai-chat.d.ts
+interface AiChatProps {
+  /** 传输层（必填），可使用导出的 createOpenAITransport() 创建 */
+  transport: ChatTransport;
+  /** 工具定义列表，不同场景传入不同工具赋予助手不同能力 */
+  tools?: ChatTool[];
+  /** 系统提示词 */
+  systemPrompt?: string;
+  /** 消息列表，支持 v-model:messages 受控 */
+  messages?: ChatMessage[];
+  /** 空状态欢迎语 */
+  welcome?: string;
+  /** 输入框占位文本 */
+  placeholder?: string;
+  /** 附件 accept 类型，默认 image/* */
+  accept?: string;
+  /** 单个附件最大字节数，默认 10MB */
+  maxAttachmentSize?: number;
+  /** 透传给内部 MarkdownRender 的属性 */
+  rendererProps?: Record<string, unknown>;
+}
+interface AiChatEmits {
+  /** 消息列表变化 */
+  (e: 'update:messages', messages: ChatMessage[]): void;
+  /** 用户发送消息 */
+  (e: 'send', message: ChatMessage): void;
+  /** 一轮对话完成（无更多工具调用） */
+  (e: 'finish', message: ChatMessage): void;
+  /** 对话出错 */
+  (e: 'error', error: Error): void;
+  /** 模型发起工具调用 */
+  (e: 'tool-call', toolCall: ChatToolCall): void;
+}
+interface _AiChatExposed {
+  /** 发送一条用户消息 */
+  send: (content: string, attachments?: ChatAttachment[]) => void;
+  /** 中断当前生成 */
+  abort: () => void;
+  /** 重新生成最后一条 assistant 回复 */
+  regenerate: () => void;
+  /** 清空消息 */
+  clear: () => void;
+}
+type AiChatExposed = DeconstructValue<_AiChatExposed>;
+//#endregion
+export { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed };
+//# sourceMappingURL=ai-chat.d.ts.map

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+import { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed } from "./ai-chat.js";
+export { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@veltra/ai",
+  "version": "1.4.0",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "src/**/style.ts",
+    "src/**/*.scss",
+    "dist/**/style.js",
+    "dist/**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style": {
+      "types": "./dist/style.d.ts",
+      "import": "./dist/style.js"
+    },
+    "./*": {
+      "types": "./dist/*",
+      "import": "./dist/*"
+    }
+  },
+  "dependencies": {
+    "markstream-vue": "^1.0.8"
+  },
+  "peerDependencies": {
+    "@veltra/compositions": "1.4.0",
+    "@veltra/desktop": "1.4.0",
+    "@veltra/icons": "1.4.0",
+    "@veltra/styles": "1.4.0",
+    "@veltra/utils": "1.4.0",
+    "vue": ">=3.5.40"
+  }
+}

package/src/chat/__test__/use-chat.test.ts

@@ -0,0 +1,246 @@
+import { describe, expect, it, vi } from 'vitest'
+import { nextTick } from 'vue'
+
+import type { AiChatEmits } from '../../types'
+import type { ChatTool, ChatTransport, ChatTransportHandlers, ChatTransportRequest } from '../types'
+import { useChat } from '../use-chat'
+
+const createEmit = () => vi.fn() as unknown as AiChatEmits & ReturnType<typeof vi.fn>
+
+/** 文本流式 mock transport */
+const textTransport = (text: string): ChatTransport => {
+  return (_req, handlers) => {
+    handlers.onTextDelta(text)
+  }
+}
+
+const waitFinish = async (emit: ReturnType<typeof vi.fn>) => {
+  await vi.waitFor(() => {
+    expect(emit).toHaveBeenCalledWith('finish', expect.anything())
+  })
+}
+
+describe('useChat', () => {
+  it('流式追加 assistant 消息并发出 finish', async () => {
+    const emit = createEmit()
+    const chat = useChat({ props: { transport: textTransport('你好') }, emit })
+
+    chat.send('hi')
+    await waitFinish(emit)
+
+    const messages = chat.messages.value
+    expect(messages).toHaveLength(2)
+    expect(messages[0]).toMatchObject({ role: 'user', content: 'hi' })
+    expect(messages[1]).toMatchObject({ role: 'assistant', content: '你好', status: 'done' })
+    expect(chat.running.value).toBe(false)
+    expect(emit).toHaveBeenCalledWith('update:messages', expect.any(Array))
+  })
+
+  it('追加思考内容', async () => {
+    const emit = createEmit()
+    const transport: ChatTransport = (_req, handlers) => {
+      handlers.onReasoningDelta?.('想一下')
+      handlers.onTextDelta('答案')
+    }
+    const chat = useChat({ props: { transport }, emit })
+
+    chat.send('1+1=?')
+    await waitFinish(emit)
+
+    expect(chat.messages.value[1]).toMatchObject({ reasoning: '想一下', content: '答案' })
+  })
+
+  it('工具调用：执行工具、追加 tool 消息并继续第二轮请求', async () => {
+    const emit = createEmit()
+    const requests: ChatTransportRequest[] = []
+
+    const transport: ChatTransport = (req, handlers) => {
+      requests.push(req)
+      if (requests.length === 1) {
+        handlers.onToolCall?.({ id: 'call-1', name: 'add', arguments: '{"a":1,"b":2}' })
+      } else {
+        handlers.onTextDelta('结果是 3')
+      }
+    }
+
+    const execute = vi.fn(({ a, b }: { a: number; b: number }) => a + b)
+    const tools: ChatTool[] = [{ name: 'add', description: '加法', parameters: {}, execute }]
+
+    const chat = useChat({ props: { transport, tools }, emit })
+    chat.send('算一下')
+    await waitFinish(emit)
+
+    expect(execute).toHaveBeenCalledWith(
+      { a: 1, b: 2 },
+      expect.objectContaining({ toolCall: expect.anything() })
+    )
+    expect(transport && requests).toHaveLength(2)
+
+    const messages = chat.messages.value
+    expect(messages.map((m) => m.role)).toEqual(['user', 'assistant', 'tool', 'assistant'])
+    expect(messages[1].toolCalls?.[0]).toMatchObject({ status: 'success', result: '3' })
+    expect(messages[2]).toMatchObject({ role: 'tool', toolCallId: 'call-1', content: '3' })
+
+    // 第二轮请求的消息历史中包含工具结果
+    const secondReqMessages = requests[1].messages
+    expect(secondReqMessages.some((m) => m.role === 'tool' && m.toolCallId === 'call-1')).toBe(true)
+  })
+
+  it('needsConfirm 工具：确认后才执行', async () => {
+    const emit = createEmit()
+
+    const transport: ChatTransport = (_req, handlers) => {
+      handlers.onToolCall?.({ id: 'call-1', name: 'del', arguments: '{}' })
+    }
+
+    const execute = vi.fn()
+    const tools: ChatTool[] = [
+      { name: 'del', description: '删除', parameters: {}, needsConfirm: true, execute }
+    ]
+
+    const chat = useChat({ props: { transport, tools }, emit })
+    chat.send('删除文件')
+
+    // 等待进入待确认状态
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].toolCalls?.[0].status).toBe('awaiting-confirm')
+    })
+    expect(execute).not.toHaveBeenCalled()
+
+    chat.respondToolCall('call-1', true)
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].toolCalls?.[0].status).toBe('success')
+    })
+    expect(execute).toHaveBeenCalled()
+  })
+
+  it('needsConfirm 工具：拒绝后不执行并回灌拒绝信息', async () => {
+    const emit = createEmit()
+    let round = 0
+
+    const transport: ChatTransport = (_req, handlers) => {
+      round++
+      if (round === 1) {
+        handlers.onToolCall?.({ id: 'call-1', name: 'del', arguments: '{}' })
+      } else {
+        handlers.onTextDelta('好的，不删了')
+      }
+    }
+
+    const execute = vi.fn()
+    const tools: ChatTool[] = [
+      { name: 'del', description: '删除', parameters: {}, needsConfirm: true, execute }
+    ]
+
+    const chat = useChat({ props: { transport, tools }, emit })
+    chat.send('删除文件')
+
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].toolCalls?.[0].status).toBe('awaiting-confirm')
+    })
+
+    chat.respondToolCall('call-1', false)
+    await waitFinish(emit)
+
+    const toolCall = chat.messages.value[1].toolCalls?.[0]
+    expect(toolCall?.status).toBe('rejected')
+    expect(execute).not.toHaveBeenCalled()
+    expect(chat.messages.value[2].content).toContain('rejected')
+  })
+
+  it('abort 中断生成', async () => {
+    const emit = createEmit()
+
+    const transport: ChatTransport = (req, handlers: ChatTransportHandlers) => {
+      return new Promise<void>((resolve) => {
+        req.signal.addEventListener('abort', () => resolve(), { once: true })
+        handlers.onTextDelta('部分')
+      })
+    }
+
+    const chat = useChat({ props: { transport }, emit })
+    chat.send('hi')
+
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].content).toBe('部分')
+    })
+
+    chat.abort()
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].status).toBe('aborted')
+    })
+    expect(chat.running.value).toBe(false)
+    expect(emit).not.toHaveBeenCalledWith('finish', expect.anything())
+  })
+
+  it('transport 报错时标记 error 并发出 error 事件', async () => {
+    const emit = createEmit()
+    const failure = new Error('网络错误')
+
+    const transport: ChatTransport = (_req, handlers) => {
+      handlers.onError?.(failure)
+    }
+
+    const chat = useChat({ props: { transport }, emit })
+    chat.send('hi')
+
+    await vi.waitFor(() => {
+      expect(emit).toHaveBeenCalledWith('error', failure)
+    })
+    expect(chat.messages.value[1].status).toBe('error')
+    expect(chat.running.value).toBe(false)
+  })
+
+  it('regenerate 移除最后一轮回复并重新生成', async () => {
+    const emit = createEmit()
+    let round = 0
+
+    const transport: ChatTransport = (_req, handlers) => {
+      round++
+      handlers.onTextDelta(`回答${round}`)
+    }
+
+    const chat = useChat({ props: { transport }, emit })
+    chat.send('问')
+    await waitFinish(emit)
+    expect(chat.messages.value[1].content).toBe('回答1')
+
+    chat.regenerate()
+    await vi.waitFor(() => {
+      expect(chat.messages.value[1].content).toBe('回答2')
+    })
+    expect(chat.messages.value).toHaveLength(2)
+  })
+
+  it('生成中忽略重复 send', async () => {
+    const emit = createEmit()
+    let resolveStream: (() => void) | undefined
+
+    const transport: ChatTransport = (req) => {
+      return new Promise<void>((resolve) => {
+        resolveStream = resolve
+        req.signal.addEventListener('abort', () => resolve(), { once: true })
+      })
+    }
+
+    const chat = useChat({ props: { transport }, emit })
+    chat.send('第一条')
+    chat.send('第二条')
+    resolveStream?.()
+
+    await waitFinish(emit)
+    expect(chat.messages.value.filter((m) => m.role === 'user')).toHaveLength(1)
+  })
+
+  it('clear 清空消息', async () => {
+    const emit = createEmit()
+    const chat = useChat({ props: { transport: textTransport('x') }, emit })
+
+    chat.send('hi')
+    await waitFinish(emit)
+
+    chat.clear()
+    await nextTick()
+    expect(chat.messages.value).toHaveLength(0)
+  })
+})

package/src/chat/index.ts

@@ -0,0 +1,3 @@
+export * from './types'
+export * from './use-chat'
+export * from './transports'

package/src/chat/transports/index.ts

@@ -0,0 +1 @@
+export * from './openai'