@veltra/ai 2.1.5 → 2.1.7

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

@@ -1 +1 @@
-{"version":3,"file":"tool-call.js","names":[],"sources":["../../../src/components/ai-chat/tool-call.vue"],"sourcesContent":["<template>\n  <UCollapseItem\n    v-model=\"isExpanded\"\n    :class=\"[cls.e('tool-call'), bem.is(toolCall.status)]\"\n    :destroy-on-collapse=\"destroyOnCollapse\"\n    @change=\"markUserToggled\"\n  >\n    <template #header>\n      <UIcon :class=\"[cls.e('tool-call-status'), statusClass]\">\n        <component :is=\"headerIcon\" />\n      </UIcon>\n      <span :class=\"[cls.e('tool-call-name'), isActive && 'u-shine']\">\n        {{ tool?.label ?? toolCall.name }}\n      </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        @keydown.enter.stop\n        @keydown.space.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 展示在右侧侧边面板，卡片 body 仅提供查看入口 -->\n    <div v-if=\"isPanelTool\" :class=\"cls.e('tool-call-panel-entry')\">\n      <span :class=\"cls.e('tool-call-panel-hint')\">内容展示在右侧面板</span>\n      <UButton size=\"small\" text type=\"primary\" @click=\"di?.openPanel(toolCall.id)\">\n        查看面板\n      </UButton>\n    </div>\n    <!-- 自定义渲染：工具定义的 render 优先于 tool-<name> 插槽，均替换整个 body -->\n    <component :is=\"tool.render\" v-else-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</template>\n\n<script lang=\"ts\" setup>\nimport { UButton, UCollapseItem, UIcon } from '@veltra/desktop'\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/terminal） */\nconst tool = computed(() => di?.tools.value[props.toolCall.name])\n\nconst isExpanded = ref(false)\n/** 用户手动切换过后，不再随 status 自动展开/折叠 */\nlet userToggled: boolean = false\n\n/** UCollapseItem 的 change 仅在用户点击头部时触发（程序化 v-model 变更不触发） */\nconst markUserToggled = () => {\n  userToggled = true\n}\n\n/** 面板工具：render 展示在右侧侧边面板，卡片 body 仅保留「查看面板」入口 */\nconst isPanelTool = computed(() => tool.value?.renderTo === 'panel')\n\n/** 完成后是否自动折叠：缺省面板工具折叠；有 render 时不折叠，否则折叠 */\nconst autoCollapse = computed(\n  () => tool.value?.autoCollapse ?? (isPanelTool.value || !tool.value?.render)\n)\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-active' },\n  running: { icon: Loading, class: 'is-active' },\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/** 进行中（pending/running）：工具名带扫光效果 */\nconst isActive = computed(() => {\n  return props.toolCall.status === 'pending' || props.toolCall.status === 'running'\n})\n\n/** 终态（成功/失败/拒绝） */\nconst isSettled = computed(() => {\n  return ['success', 'error', 'rejected'].includes(props.toolCall.status)\n})\n\n/**\n * 折叠后卸载内容 DOM：仅终态且非面板工具时启用——\n * 进行中/待确认要保留内容状态（确认按钮、表单），面板工具的 body 是「查看面板」入口必须可达\n */\nconst destroyOnCollapse = computed(() => isSettled.value && !isPanelTool.value)\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":"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"}
+{"version":3,"file":"tool-call.js","names":[],"sources":["../../../src/components/ai-chat/tool-call.vue"],"sourcesContent":["<template>\n  <UCollapseItem\n    v-model=\"isExpanded\"\n    :class=\"[cls.e('tool-call'), bem.is(toolCall.status)]\"\n    :destroy-on-collapse=\"destroyOnCollapse\"\n    @change=\"markUserToggled\"\n  >\n    <template #header>\n      <UIcon :class=\"[cls.e('tool-call-status'), statusClass]\">\n        <component :is=\"headerIcon\" />\n      </UIcon>\n      <span :class=\"[cls.e('tool-call-name'), isActive && 'u-shine']\">\n        {{ tool?.label ?? toolCall.name }}\n      </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        @keydown.enter.stop\n        @keydown.space.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 展示在右侧侧边面板，卡片 body 仅提供查看入口 -->\n    <div v-if=\"isPanelTool\" :class=\"cls.e('tool-call-panel-entry')\">\n      <span :class=\"cls.e('tool-call-panel-hint')\">内容展示在右侧面板</span>\n      <UButton size=\"small\" text type=\"primary\" @click=\"di?.openPanel(toolCall.id)\">\n        查看面板\n      </UButton>\n    </div>\n    <!-- 自定义渲染：meta.render / tool-<name> 插槽优先于通用工具视图 -->\n    <component :is=\"tool.render\" v-else-if=\"tool?.render\" :tool-call=\"toolCall\" />\n    <component :is=\"slotBody\" v-else-if=\"slotBody && hasResult\" />\n    <template v-else>\n      <ToolJson v-if=\"prettyArguments\" title=\"参数\" :text=\"prettyArguments\" />\n      <ToolJson v-if=\"hasResult\" :title=\"resultTitle\" :text=\"displayResult\" />\n      <ToolJson v-if=\"prettyView\" title=\"视图\" :text=\"prettyView\" />\n    </template>\n  </UCollapseItem>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UButton, UCollapseItem, UIcon } from '@veltra/desktop'\nimport { bem } from '@veltra/utils'\nimport { computed, inject, ref, watch } from 'vue'\n\nimport type { ChatToolCall } from '../../chat/types'\nimport { AiChatDIKey } from './di'\nimport { resolveToolIcon } from './tool-icons'\nimport ToolJson from './tool-json.vue'\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/** 把未知值格式成可读 JSON，循环引用等异常时退回 String，不得 throw */\nfunction formatUnknown(value: unknown): string {\n  if (value == null) return ''\n  if (typeof value === 'string') {\n    try {\n      return JSON.stringify(JSON.parse(value), null, 2)\n    } catch {\n      return value\n    }\n  }\n  try {\n    return JSON.stringify(value, null, 2) ?? String(value)\n  } catch {\n    return String(value)\n  }\n}\n\n/** 当前调用对应的工具定义或渲染元信息（session 下忽略 execute / needsConfirm / terminal） */\nconst tool = computed(() => di?.tools.value[props.toolCall.name])\n\nconst isExpanded = ref(false)\n/** 用户手动切换过后，不再随 status 自动展开/折叠 */\nlet userToggled: boolean = false\n\n/** UCollapseItem 的 change 仅在用户点击头部时触发（程序化 v-model 变更不触发） */\nconst markUserToggled = () => {\n  userToggled = true\n}\n\n/** 面板工具：render 展示在右侧侧边面板，卡片 body 仅保留「查看面板」入口 */\nconst isPanelTool = computed(() => tool.value?.renderTo === 'panel')\n\n/** 完成后是否自动折叠：缺省面板工具折叠；有 render 时不折叠，否则折叠 */\nconst autoCollapse = computed(\n  () => tool.value?.autoCollapse ?? (isPanelTool.value || !tool.value?.render)\n)\n\nwatch(\n  () => props.toolCall.status,\n  (status) => {\n    if (userToggled) return\n    if (status === 'pending' || 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_CLASS: Record<string, string> = {\n  pending: 'is-active',\n  running: 'is-active',\n  'awaiting-confirm': 'is-warning',\n  success: 'is-success',\n  error: 'is-danger',\n  rejected: 'is-danger'\n}\n\nconst statusClass = computed(() => STATUS_CLASS[props.toolCall.status] ?? '')\n\n/** 进行中（pending/running）：工具名带扫光效果 */\nconst isActive = computed(() => {\n  return props.toolCall.status === 'pending' || props.toolCall.status === 'running'\n})\n\n/** 终态（成功/失败/拒绝） */\nconst isSettled = computed(() => {\n  return ['success', 'error', 'rejected'].includes(props.toolCall.status)\n})\n\n/**\n * 折叠后卸载内容 DOM：仅终态且非面板工具时启用——\n * 进行中/待确认要保留内容状态（确认按钮、表单），面板工具的 body 是「查看面板」入口必须可达\n */\nconst destroyOnCollapse = computed(() => isSettled.value && !isPanelTool.value)\n\n/** 头部图标：meta.icon > 宿主覆盖 > 内置名称规则 > 兜底；状态点走 status class */\nconst headerIcon = computed(\n  () => tool.value?.icon ?? resolveToolIcon(props.toolCall.name, di?.toolIcons?.value)\n)\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 resultTitle = computed(() => (props.toolCall.status === 'error' ? '错误' : '结果'))\n\nconst displayResult = computed(() => formatUnknown(props.toolCall.error ?? props.toolCall.result))\n\n/** 服务端下发的 view，格式化为 JSON；不得丢弃、不得 throw */\nconst prettyView = computed(() => {\n  if (props.toolCall.view == null) return ''\n  return formatUnknown(props.toolCall.view)\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":"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"}

package/dist/components/ai-chat/tool-icons.js

@@ -0,0 +1,31 @@
+import { EditPen, Folder, Internet, QuestionFilled, Terminal, Tools } from "@veltra/icons/normal";
+//#region src/components/ai-chat/tool-icons.ts
+/**
+* 内置 toolName → icon：按名称子串匹配，顺序即优先级。
+* 未命中任何规则时走兜底图标，不得 throw。
+*/
+const TOOL_ICON_RULES = [
+	[["bash", "terminal"], Terminal],
+	[["fs", "file"], Folder],
+	[["web", "globe"], Internet],
+	[["edit", "pencil"], EditPen],
+	[["ask", "question"], QuestionFilled]
+];
+/** 未知名工具的兜底图标 */
+const FALLBACK_TOOL_ICON = Tools;
+/**
+* 按工具名解析图标。
+* 宿主 `toolIcons` 精确名覆盖优先于内置规则；都未命中则兜底。
+*/
+function resolveToolIcon(name, overrides) {
+	const key = String(name ?? "");
+	const fromOverride = overrides?.[key];
+	if (fromOverride) return fromOverride;
+	const lower = key.toLowerCase();
+	for (const [needles, icon] of TOOL_ICON_RULES) if (needles.some((needle) => lower.includes(needle))) return icon;
+	return FALLBACK_TOOL_ICON;
+}
+//#endregion
+export { FALLBACK_TOOL_ICON, resolveToolIcon };
+
+//# sourceMappingURL=tool-icons.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-icons.js","names":[],"sources":["../../../src/components/ai-chat/tool-icons.ts"],"sourcesContent":["import { EditPen, Folder, Internet, QuestionFilled, Terminal, Tools } from '@veltra/icons/normal'\nimport type { Component } from 'vue'\n\n/**\n * 内置 toolName → icon：按名称子串匹配，顺序即优先级。\n * 未命中任何规则时走兜底图标，不得 throw。\n */\nconst TOOL_ICON_RULES: [needles: string[], icon: Component][] = [\n  [['bash', 'terminal'], Terminal],\n  [['fs', 'file'], Folder],\n  [['web', 'globe'], Internet],\n  [['edit', 'pencil'], EditPen],\n  [['ask', 'question'], QuestionFilled]\n]\n\n/** 未知名工具的兜底图标 */\nexport const FALLBACK_TOOL_ICON: Component = Tools\n\n/**\n * 按工具名解析图标。\n * 宿主 `toolIcons` 精确名覆盖优先于内置规则；都未命中则兜底。\n */\nexport function resolveToolIcon(name: string, overrides?: Record<string, Component>): Component {\n  const key = String(name ?? '')\n  const fromOverride = overrides?.[key]\n  if (fromOverride) return fromOverride\n\n  const lower = key.toLowerCase()\n  for (const [needles, icon] of TOOL_ICON_RULES) {\n    if (needles.some((needle) => lower.includes(needle))) return icon\n  }\n  return FALLBACK_TOOL_ICON\n}\n"],"mappings":";;;;;;AAOA,MAAM,kBAA0D;CAC9D,CAAC,CAAC,QAAQ,UAAU,GAAG,QAAQ;CAC/B,CAAC,CAAC,MAAM,MAAM,GAAG,MAAM;CACvB,CAAC,CAAC,OAAO,OAAO,GAAG,QAAQ;CAC3B,CAAC,CAAC,QAAQ,QAAQ,GAAG,OAAO;CAC5B,CAAC,CAAC,OAAO,UAAU,GAAG,cAAc;AACtC;;AAGA,MAAa,qBAAgC;;;;;AAM7C,SAAgB,gBAAgB,MAAc,WAAkD;CAC9F,MAAM,MAAM,OAAO,QAAQ,EAAE;CAC7B,MAAM,eAAe,YAAY;CACjC,IAAI,cAAc,OAAO;CAEzB,MAAM,QAAQ,IAAI,YAAY;CAC9B,KAAK,MAAM,CAAC,SAAS,SAAS,iBAC5B,IAAI,QAAQ,MAAM,WAAW,MAAM,SAAS,MAAM,CAAC,GAAG,OAAO;CAE/D,OAAO;AACT"}

package/dist/components/ai-chat/tool-json.js

@@ -0,0 +1,40 @@
+import { AiChatDIKey } from "./di.js";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, defineComponent, inject, normalizeClass, openBlock, ref, toDisplayString, unref, withCtx } from "vue";
+import { UButton } from "@veltra/desktop";
+import { bem } from "@veltra/utils";
+//#region src/components/ai-chat/tool-json.vue
+const PREVIEW_LIMIT = 480;
+const _sfc_main = /*@__PURE__*/ defineComponent({
+	name: "UAiChatToolJson",
+	__name: "tool-json",
+	props: {
+		title: {},
+		text: {}
+	},
+	setup(__props) {
+		const cls = inject(AiChatDIKey)?.cls ?? bem("ai-chat");
+		const expanded = ref(false);
+		const overLimit = computed(() => __props.text.length > PREVIEW_LIMIT);
+		const shown = computed(() => {
+			if (expanded.value || !overLimit.value) return __props.text;
+			return `${__props.text.slice(0, PREVIEW_LIMIT)}…`;
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", { class: normalizeClass(unref(cls).e("tool-call-json")) }, [createElementVNode("div", { class: normalizeClass(unref(cls).e("tool-call-json-head")) }, [createElementVNode("span", { class: normalizeClass(unref(cls).e("tool-call-section")) }, toDisplayString(__props.title), 3), overLimit.value ? (openBlock(), createBlock(unref(UButton), {
+				key: 0,
+				class: normalizeClass(unref(cls).e("tool-call-json-toggle")),
+				size: "small",
+				text: "",
+				type: "primary",
+				onClick: _cache[0] || (_cache[0] = ($event) => expanded.value = !expanded.value)
+			}, {
+				default: withCtx(() => [createTextVNode(toDisplayString(expanded.value ? "收起" : "展开"), 1)]),
+				_: 1
+			}, 8, ["class"])) : createCommentVNode("v-if", true)], 2), createElementVNode("pre", { class: normalizeClass([unref(cls).e("tool-call-code"), unref(bem).is("truncated", overLimit.value && !expanded.value)]) }, toDisplayString(shown.value), 3)], 2);
+		};
+	}
+});
+//#endregion
+export { _sfc_main as default };
+
+//# sourceMappingURL=tool-json.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-json.js","names":[],"sources":["../../../src/components/ai-chat/tool-json.vue"],"sourcesContent":["<template>\n  <div :class=\"cls.e('tool-call-json')\">\n    <div :class=\"cls.e('tool-call-json-head')\">\n      <span :class=\"cls.e('tool-call-section')\">{{ title }}</span>\n      <UButton\n        v-if=\"overLimit\"\n        :class=\"cls.e('tool-call-json-toggle')\"\n        size=\"small\"\n        text\n        type=\"primary\"\n        @click=\"expanded = !expanded\"\n      >\n        {{ expanded ? '收起' : '展开' }}\n      </UButton>\n    </div>\n    <pre :class=\"[cls.e('tool-call-code'), bem.is('truncated', overLimit && !expanded)]\">{{\n      shown\n    }}</pre>\n  </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UButton } from '@veltra/desktop'\nimport { bem } from '@veltra/utils'\nimport { computed, inject, ref } from 'vue'\n\nimport { AiChatDIKey } from './di'\n\ndefineOptions({ name: 'UAiChatToolJson' })\n\n/** 超过该字符数截断，展开后可见全文 */\nconst PREVIEW_LIMIT = 480\n\nconst { title, text } = defineProps<{\n  /** 区块标题（参数 / 结果 / 视图） */\n  title: string\n  /** 已格式化的 JSON 或原文 */\n  text: string\n}>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\nconst expanded = ref(false)\n\nconst overLimit = computed(() => text.length > PREVIEW_LIMIT)\n\nconst shown = computed(() => {\n  if (expanded.value || !overLimit.value) return text\n  return `${text.slice(0, PREVIEW_LIMIT)}…`\n})\n</script>\n"],"mappings":";;;;;AA+BA,MAAM,gBAAgB;;;;;;;;;EAUtB,MAAM,MADK,OAAO,WACN,CAAA,EAAI,OAAO,IAAI,SAAS;EAEpC,MAAM,WAAW,IAAI,KAAK;EAE1B,MAAM,YAAY,eAAe,QAAA,KAAK,SAAS,aAAa;EAE5D,MAAM,QAAQ,eAAe;GAC3B,IAAI,SAAS,SAAS,CAAC,UAAU,OAAO,OAAO,QAAA;GAC/C,OAAO,GAAG,QAAA,KAAK,MAAM,GAAG,aAAa,EAAE;EACzC,CAAC;;GAjDC,OAAA,UAAA,GAAA,mBAiBM,OAAA,EAjBA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAA,GAChB,CAAA,mBAYM,OAAA,EAZA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,qBAAA,CAAA,EAAA,GAChB,CAAA,mBAA4D,QAAA,EAArD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA,EAA0B,GAAA,gBAAA,QAAA,KAAK,GAAA,CAAA,GAE1C,UAAA,SADR,UAAA,GAAA,YASU,MAAA,OAAA,GAAA;;IAPP,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,uBAAA,CAAA;IACb,MAAK;IACL,MAAA;IACA,MAAK;IACJ,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,SAAA,QAAQ,CAAI,SAAA;;IAEpB,SAAA,cAA4B,CAAzB,gBAAA,gBAAA,SAAA,QAAQ,OAAA,IAAA,GAAA,CAAA,CAAA,CAAA;;GAGf,GAAA,GAAA,CAAA,OAAA,CAAA,KAAA,mBAAA,QAAA,IAAA,CAAA,GAAA,CAAA,GAAA,mBAEQ,OAAA,EAFF,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,GAAoB,MAAA,GAAA,CAAG,CAAC,GAAE,aAAc,UAAA,SAAS,CAAK,SAAA,KAAQ,CAAA,CAAA,EAC/E,GAAA,gBAAA,MAAA,KAAK,GAAA,CAAA,CAAA,GAAA,CAAA"}

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

@@ -14,7 +14,7 @@
 * --u-height-default: 32px;
 * --u-height-small: 24px;
 */
-/** 暗色：data-theme 与系统偏好，与 UITheme.injectBuiltInThemes 选择器策略一致 */
+/** 暗色：`UITheme.render()` 按主题系列写入 html[data-theme] */
 .u-ai-orb {
   display: block;
   flex-shrink: 0;

package/dist/index.d.ts

@@ -1,13 +1,15 @@
 import _sfc_main$1 from "./components/ai-orb/ai-orb.js";
 import _sfc_main from "./components/ai-chat/ai-chat.js";
-import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus } from "./chat/types.js";
+import { ChatAttachment, ChatJob, ChatJobStatus, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolMeta, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus } from "./chat/types.js";
+import { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult } from "./tools/ask-question/ask-question.js";
+import "./tools/index.js";
+import { ChatSessionAdapter, ChatSessionEvent, ChatSessionTransport, createServerTransport, isServerTransport } from "./chat/session.js";
 import { ChatModel, ChatModelOption, ChatProvider, ChatReasoningLevel } from "./providers/types.js";
 import { AiChatEmits, AiChatExposed, AiChatProps, _AiChatExposed } from "./types/ai-chat.js";
 import { AiOrbEmits, AiOrbExposed, AiOrbProps, AiOrbReaction, AiOrbStatus } from "./types/ai-orb.js";
 import "./types/index.js";
+import { ChatFoldState, ChatPendingApproval, createFoldState, foldSessionEvent } from "./chat/fold.js";
 import { UseChatOptions, useChat } from "./chat/use-chat.js";
 import { OpenAITransport, OpenAITransportOptions, createOpenAITransport } from "./chat/transports/openai.js";
 import "./chat/index.js";
-import { AskQuestionAnswer, AskQuestionArgs, AskQuestionItem, AskQuestionResult } from "./tools/ask-question/ask-question.js";
-import "./tools/index.js";
-export { type AiChatEmits, type AiChatExposed, type AiChatProps, type AiOrbEmits, type AiOrbExposed, type AiOrbProps, type AiOrbReaction, type AiOrbStatus, type AskQuestionAnswer, type AskQuestionArgs, type AskQuestionItem, type AskQuestionResult, ChatAttachment, ChatMessage, type ChatModel, type ChatModelOption, type ChatProvider, ChatQueuedMessage, type ChatReasoningLevel, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, OpenAITransport, OpenAITransportOptions, ToolCallStatus, _sfc_main as UAiChat, _sfc_main$1 as UAiOrb, UseChatOptions, type _AiChatExposed, createOpenAITransport, useChat };
+export { type AiChatEmits, type AiChatExposed, type AiChatProps, type AiOrbEmits, type AiOrbExposed, type AiOrbProps, type AiOrbReaction, type AiOrbStatus, type AskQuestionAnswer, type AskQuestionArgs, type AskQuestionItem, type AskQuestionResult, ChatAttachment, ChatFoldState, ChatJob, ChatJobStatus, ChatMessage, type ChatModel, type ChatModelOption, ChatPendingApproval, type ChatProvider, ChatQueuedMessage, type ChatReasoningLevel, ChatSessionAdapter, ChatSessionEvent, ChatSessionTransport, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolMeta, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, OpenAITransport, OpenAITransportOptions, ToolCallStatus, _sfc_main as UAiChat, _sfc_main$1 as UAiOrb, UseChatOptions, type _AiChatExposed, createFoldState, createOpenAITransport, createServerTransport, foldSessionEvent, isServerTransport, useChat };

package/dist/index.js

@@ -1,5 +1,7 @@
+import { createServerTransport, isServerTransport } from "./chat/session.js";
+import { createFoldState, foldSessionEvent } from "./chat/fold.js";
 import { useChat } from "./chat/use-chat.js";
 import { createOpenAITransport } from "./chat/transports/openai.js";
 import _sfc_main$1 from "./components/ai-orb/ai-orb.js";
 import _sfc_main from "./components/ai-chat/ai-chat.js";
-export { _sfc_main as UAiChat, _sfc_main$1 as UAiOrb, createOpenAITransport, useChat };
+export { _sfc_main as UAiChat, _sfc_main$1 as UAiOrb, createFoldState, createOpenAITransport, createServerTransport, foldSessionEvent, isServerTransport, useChat };

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

@@ -1,5 +1,6 @@
-import { deferAskQuestion, takeAskQuestionDeferred } from "./deferred.js";
 import _sfc_main from "../../components/ai-chat/ask-question.js";
+import { deferAskQuestion, resolveAskQuestion, takeAskQuestionDeferred } from "./deferred.js";
+import { computed, defineComponent, h } from "vue";
 import { QuestionFilled } from "@veltra/icons/normal";
 //#region src/tools/ask-question/ask-question.ts
 const DEFAULT_DESCRIPTION = "当需求不明确或存在歧义时，向用户提问以澄清。一次可提 1-4 个关键问题；每个问题可提供若干预设选项，用户可选择选项或自定义输入。用户作答后再继续生成。";
@@ -33,6 +34,51 @@ const QUESTIONS_SCHEMA = {
 	} },
 	required: ["questions"]
 };
+function parseQuestions(toolCall) {
+	try {
+		const args = JSON.parse(toolCall.arguments || "{}");
+		return Array.isArray(args.questions) ? args.questions : [];
+	} catch {
+		return [];
+	}
+}
+function parseAnswers(toolCall) {
+	if (toolCall.status !== "success" || !toolCall.result) return void 0;
+	try {
+		const result = JSON.parse(toolCall.result);
+		return Array.isArray(result.answers) ? result.answers : void 0;
+	} catch {
+		return;
+	}
+}
+function statusError(toolCall) {
+	if (toolCall.status !== "error") return void 0;
+	const err = toolCall.error ?? "";
+	if (err.includes("Abort") || err.includes("取消")) return "已取消";
+	return err || "提问失败";
+}
+/** 把 toolCall 转成提问表单的 questions / onSubmit；提交仍走 resolveAskQuestion */
+const AskQuestionRender = defineComponent({
+	name: "AskQuestionRender",
+	props: { toolCall: {
+		type: Object,
+		required: true
+	} },
+	setup(props) {
+		const questions = computed(() => parseQuestions(props.toolCall));
+		const answers = computed(() => parseAnswers(props.toolCall));
+		const error = computed(() => statusError(props.toolCall));
+		const onSubmit = (value) => {
+			resolveAskQuestion(props.toolCall.id, { answers: Array.isArray(value) ? value : value.answers });
+		};
+		return () => h(_sfc_main, {
+			questions: questions.value,
+			answers: answers.value,
+			error: error.value,
+			onSubmit
+		});
+	}
+});
 /**
 * 创建内置提问工具：execute 挂起等待用户在 UI 中作答，提交后结果回灌模型。
 * 工具卡片由内联提问表单渲染（多题分页导航，提交后展示问答摘要，不自动折叠）。
@@ -45,7 +91,7 @@ function createAskQuestionTool(options = {}) {
 		parameters: QUESTIONS_SCHEMA,
 		icon,
 		label,
-		render: _sfc_main,
+		render: AskQuestionRender,
 		execute: (_args, { toolCall, signal }) => new Promise((resolve, reject) => {
 			deferAskQuestion(toolCall.id, {
 				resolve,

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

@@ -1 +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"}
+{"version":3,"file":"ask-question.js","names":["AskQuestion"],"sources":["../../../src/tools/ask-question/ask-question.ts"],"sourcesContent":["import { QuestionFilled } from '@veltra/icons/normal'\nimport { computed, defineComponent, h, type Component, type PropType } from 'vue'\n\nimport type { ChatTool, ChatToolCall } from '../../chat/types'\nimport AskQuestion from '../../components/ai-chat/ask-question.vue'\nimport { deferAskQuestion, resolveAskQuestion, 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\nfunction parseQuestions(toolCall: ChatToolCall): AskQuestionItem[] {\n  try {\n    const args = JSON.parse(toolCall.arguments || '{}') as Partial<AskQuestionArgs>\n    return Array.isArray(args.questions) ? args.questions : []\n  } catch {\n    return []\n  }\n}\n\nfunction parseAnswers(toolCall: ChatToolCall): AskQuestionAnswer[] | undefined {\n  if (toolCall.status !== 'success' || !toolCall.result) return undefined\n  try {\n    const result = JSON.parse(toolCall.result) as Partial<AskQuestionResult>\n    return Array.isArray(result.answers) ? result.answers : undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction statusError(toolCall: ChatToolCall): string | undefined {\n  if (toolCall.status !== 'error') return undefined\n  const err = toolCall.error ?? ''\n  if (err.includes('Abort') || err.includes('取消')) return '已取消'\n  return err || '提问失败'\n}\n\n/** 把 toolCall 转成提问表单的 questions / onSubmit；提交仍走 resolveAskQuestion */\nconst AskQuestionRender = defineComponent({\n  name: 'AskQuestionRender',\n  props: { toolCall: { type: Object as PropType<ChatToolCall>, required: true } },\n  setup(props) {\n    const questions = computed(() => parseQuestions(props.toolCall))\n    const answers = computed(() => parseAnswers(props.toolCall))\n    const error = computed(() => statusError(props.toolCall))\n    const onSubmit = (value: AskQuestionAnswer[] | AskQuestionResult) => {\n      resolveAskQuestion(props.toolCall.id, {\n        answers: Array.isArray(value) ? value : value.answers\n      })\n    }\n    return () =>\n      h(AskQuestion, {\n        questions: questions.value,\n        answers: answers.value,\n        error: error.value,\n        onSubmit\n      })\n  }\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: AskQuestionRender,\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;AAEA,SAAS,eAAe,UAA2C;CACjE,IAAI;EACF,MAAM,OAAO,KAAK,MAAM,SAAS,aAAa,IAAI;EAClD,OAAO,MAAM,QAAQ,KAAK,SAAS,IAAI,KAAK,YAAY,CAAC;CAC3D,QAAQ;EACN,OAAO,CAAC;CACV;AACF;AAEA,SAAS,aAAa,UAAyD;CAC7E,IAAI,SAAS,WAAW,aAAa,CAAC,SAAS,QAAQ,OAAO,KAAA;CAC9D,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,SAAS,MAAM;EACzC,OAAO,MAAM,QAAQ,OAAO,OAAO,IAAI,OAAO,UAAU,KAAA;CAC1D,QAAQ;EACN;CACF;AACF;AAEA,SAAS,YAAY,UAA4C;CAC/D,IAAI,SAAS,WAAW,SAAS,OAAO,KAAA;CACxC,MAAM,MAAM,SAAS,SAAS;CAC9B,IAAI,IAAI,SAAS,OAAO,KAAK,IAAI,SAAS,IAAI,GAAG,OAAO;CACxD,OAAO,OAAO;AAChB;;AAGA,MAAM,oBAAoB,gBAAgB;CACxC,MAAM;CACN,OAAO,EAAE,UAAU;EAAE,MAAM;EAAkC,UAAU;CAAK,EAAE;CAC9E,MAAM,OAAO;EACX,MAAM,YAAY,eAAe,eAAe,MAAM,QAAQ,CAAC;EAC/D,MAAM,UAAU,eAAe,aAAa,MAAM,QAAQ,CAAC;EAC3D,MAAM,QAAQ,eAAe,YAAY,MAAM,QAAQ,CAAC;EACxD,MAAM,YAAY,UAAmD;GACnE,mBAAmB,MAAM,SAAS,IAAI,EACpC,SAAS,MAAM,QAAQ,KAAK,IAAI,QAAQ,MAAM,QAChD,CAAC;EACH;EACA,aACE,EAAEA,WAAa;GACb,WAAW,UAAU;GACrB,SAAS,QAAQ;GACjB,OAAO,MAAM;GACb;EACF,CAAC;CACL;AACF,CAAC;;;;;AAMD,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,QAAQ;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/types/ai-chat.d.ts

@@ -1,13 +1,17 @@
-import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatTransport } from "../chat/types.js";
+import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolMeta, ChatTransport } from "../chat/types.js";
+import { ChatSessionTransport } from "../chat/session.js";
 import { ChatModelOption } from "../providers/types.js";
-import { Ref } from "vue";
+import { Component, Ref } from "vue";
 import { DeconstructValue } from "@veltra/utils";
 //#region src/types/ai-chat.d.ts
 interface AiChatProps {
-  /** 传输层（必填），可使用导出的 createOpenAITransport() 创建 */
-  transport: ChatTransport;
-  /** 工具定义列表，不同场景传入不同工具赋予助手不同能力 */
-  tools?: ChatTool[];
+  /** 传输层（必填）；函数型 ChatTransport 或 session 对象，可使用 createOpenAITransport / createServerTransport */
+  transport: ChatTransport | ChatSessionTransport;
+  /**
+   * 工具列表。函数 transport 传入 ChatTool[]（必有 execute）；
+   * session 下可为 ChatToolMeta[]（仅渲染元信息）。ChatTool[] 仍可赋值。
+   */
+  tools?: (ChatTool | ChatToolMeta)[];
   /** 系统提示词 */
   systemPrompt?: string;
   /**
@@ -41,6 +45,13 @@ interface AiChatProps {
    * 默认 false：仅在拿到 usage 时显示会话累计「总 token」。接口未返回 usage 时不展示。
    */
   tokenUsageDetail?: boolean;
+  /**
+   * 覆盖包内 toolName → icon 映射（精确名优先于内置名称规则）。
+   * 缺省不传则走内置表；未命中的名称仍用兜底图标，不得 throw。
+   */
+  toolIcons?: Record<string, Component>;
+  /** 只读：不展示输入区、欢迎语不可发送、队列无插队/编辑/移除。默认 false */
+  readonly?: boolean;
 }
 interface AiChatEmits {
   /** 消息列表变化 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/ai",
-  "version": "2.1.5",
+  "version": "2.1.7",
   "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.0"
+    "markstream-vue": "^2.0.7"
   },
   "peerDependencies": {
-    "@veltra/compositions": "^1.6.4",
-    "@veltra/desktop": "^1.6.4",
+    "@veltra/compositions": "^1.7.4",
+    "@veltra/desktop": "^1.7.4",
     "@veltra/icons": "^1.5.0",
-    "@veltra/styles": "^1.6.4",
-    "@veltra/utils": "^1.6.4",
-    "vue": ">=3.5.41"
+    "@veltra/styles": "^1.7.4",
+    "@veltra/utils": "^1.7.4",
+    "vue": ">=3.5.42"
   }
 }

package/src/chat/__test__/fold.test.ts

@@ -0,0 +1,136 @@
+import { describe, expect, it } from 'vitest'
+
+import { createFoldState, foldSessionEvent } from '../fold'
+import type { ChatSessionEvent } from '../session'
+
+const foldAll = (events: ChatSessionEvent[]) => events.reduce(foldSessionEvent, createFoldState())
+
+describe('foldSessionEvent', () => {
+  it('user/message 按服务端回显追加，不制造本地占位', () => {
+    const state = foldAll([{ type: 'user/message', messageId: 'u1', seq: 1, content: '你好' }])
+    expect(state.messages).toEqual([{ id: 'u1', role: 'user', content: '你好' }])
+  })
+
+  it('assistant/chunk 按 messageId 累积 content 与 reasoning', () => {
+    const state = foldAll([
+      { type: 'assistant/chunk', messageId: 'a1', seq: 1, delta: '你', reasoningDelta: '想' },
+      { type: 'assistant/chunk', messageId: 'a1', seq: 2, delta: '好', reasoningDelta: '一下' }
+    ])
+    expect(state.messages).toHaveLength(1)
+    expect(state.messages[0]).toMatchObject({
+      id: 'a1',
+      role: 'assistant',
+      content: '你好',
+      reasoning: '想一下',
+      status: 'streaming'
+    })
+  })
+
+  it('assistant/message 定稿内容与状态', () => {
+    const state = foldAll([
+      { type: 'assistant/chunk', messageId: 'a1', seq: 1, delta: '草' },
+      {
+        type: 'assistant/message',
+        messageId: 'a1',
+        seq: 2,
+        content: '你好世界',
+        reasoning: '想完了'
+      }
+    ])
+    expect(state.messages[0]).toMatchObject({
+      id: 'a1',
+      content: '你好世界',
+      reasoning: '想完了',
+      status: 'done'
+    })
+  })
+
+  it('tool/call 追加 pending 的 ChatToolCall 并保留 view', () => {
+    const view = { preview: 'ls' }
+    const state = foldAll([
+      { type: 'assistant/chunk', messageId: 'a1', seq: 1, delta: '' },
+      { type: 'tool/call', callId: 'c1', name: 'bash', arguments: '{"cmd":"ls"}', seq: 2, view }
+    ])
+    expect(state.messages[0]?.toolCalls).toEqual([
+      { id: 'c1', name: 'bash', arguments: '{"cmd":"ls"}', status: 'pending', view }
+    ])
+  })
+
+  it('tool/result 按 callId 更新 status / result / error / view', () => {
+    const state = foldAll([
+      { type: 'tool/call', callId: 'c1', name: 'bash', arguments: '{}', seq: 1, view: { step: 1 } },
+      {
+        type: 'tool/result',
+        callId: 'c1',
+        status: 'error',
+        result: 'out',
+        error: 'boom',
+        seq: 2,
+        view: { step: 2 }
+      }
+    ])
+    expect(state.messages[0]?.toolCalls?.[0]).toMatchObject({
+      id: 'c1',
+      status: 'error',
+      result: 'out',
+      error: 'boom',
+      view: { step: 2 }
+    })
+  })
+
+  it('queue/snapshot 与 jobs/snapshot 整体替换', () => {
+    const state = foldAll([
+      { type: 'queue/snapshot', items: [{ id: 'q1', content: '旧' }] },
+      {
+        type: 'jobs/snapshot',
+        jobs: [{ id: 'j1', kind: 'bash', label: '旧作业', status: 'running' }]
+      },
+      { type: 'queue/snapshot', items: [{ id: 'q2', content: '新' }] },
+      { type: 'jobs/snapshot', jobs: [{ id: 'j2', kind: 'web', label: '新作业', status: 'done' }] }
+    ])
+    expect(state.queue).toEqual([{ id: 'q2', content: '新' }])
+    expect(state.jobs).toEqual([{ id: 'j2', kind: 'web', label: '新作业', status: 'done' }])
+  })
+
+  it('projection：tokenUsage 合并、title 取出、其余进 projections', () => {
+    const state = foldAll([
+      {
+        type: 'projection',
+        key: 'tokenUsage',
+        seq: 1,
+        value: { promptTokens: 1, completionTokens: 2, totalTokens: 3 }
+      },
+      {
+        type: 'projection',
+        key: 'tokenUsage',
+        seq: 2,
+        value: { promptTokens: 4, completionTokens: 5, totalTokens: 9 }
+      },
+      { type: 'projection', key: 'title', seq: 3, value: '会话标题' },
+      { type: 'projection', key: 'extra', seq: 4, value: { n: 1 } }
+    ])
+    expect(state.tokenUsage).toEqual({ promptTokens: 5, completionTokens: 7, totalTokens: 12 })
+    expect(state.title).toBe('会话标题')
+    expect(state.projections).toEqual({ extra: { n: 1 } })
+    expect(state.projections).not.toHaveProperty('title')
+    expect(state.projections).not.toHaveProperty('tokenUsage')
+  })
+
+  it('乱序 seq 不覆盖已应用事件', () => {
+    const applied = foldSessionEvent(createFoldState(), {
+      type: 'user/message',
+      messageId: 'u2',
+      seq: 2,
+      content: '后到的先到'
+    })
+    const skipped = foldSessionEvent(applied, {
+      type: 'user/message',
+      messageId: 'u1',
+      seq: 1,
+      content: '乱序应丢弃'
+    })
+    expect(skipped).toBe(applied)
+    expect(skipped.messages).toEqual([{ id: 'u2', role: 'user', content: '后到的先到' }])
+    expect(skipped.lastSeq).toBe(2)
+  })
+})