@veltra/ai 2.1.3 → 2.1.5

package/dist/components/ai-chat/side-panel.js.map

@@ -1 +1 @@
-{"version":3,"file":"side-panel.js","names":[],"sources":["../../../src/components/ai-chat/side-panel.vue"],"sourcesContent":["<template>\n  <aside :class=\"cls.e('panel')\">\n    <div :class=\"cls.e('panel-card')\">\n      <div :class=\"cls.e('panel-header')\">\n        <UIcon :class=\"[cls.e('panel-icon'), statusClass]\">\n          <component :is=\"headerIcon\" />\n        </UIcon>\n        <span :class=\"cls.e('panel-title')\">{{ panelTitle }}</span>\n        <UIcon :class=\"cls.e('panel-close')\" title=\"关闭面板\" @click=\"emit('close')\">\n          <Close />\n        </UIcon>\n      </div>\n\n      <UScroll :class=\"cls.e('panel-body')\">\n        <!-- render 组件与工具卡片同一契约（ChatToolRenderProps），可随 toolCall 状态实时更新 -->\n        <component :is=\"tool.render\" v-if=\"tool?.render\" :tool-call=\"toolCall\" />\n        <pre v-else :class=\"cls.e('panel-fallback')\">{{ fallbackResult }}</pre>\n      </UScroll>\n    </div>\n  </aside>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UIcon, UScroll } from '@veltra/desktop'\nimport { CircleCheckFilled, CircleClose, Close, Loading, WarningFilled } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { computed, inject, type Component } from 'vue'\n\nimport type { ChatToolCall } from '../../chat/types'\nimport { AiChatDIKey } from './di'\n\ndefineOptions({ name: 'UAiChatSidePanel' })\n\nconst props = defineProps<{ toolCall: ChatToolCall }>()\n\nconst emit = defineEmits<{ (e: 'close'): void }>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\n/** 当前调用对应的工具定义（解析 icon/label/render） */\nconst tool = computed(() => di?.tools.value[props.toolCall.name])\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/** 头部图标：工具自定义图标优先，缺省用状态图标（与工具卡片一致） */\nconst headerIcon = computed(() => tool.value?.icon ?? statusIcon.value)\n\n/** 面板标题：优先工具定义的 panelTitle（业务对象 + 动作），缺省回落到 label ?? name */\nconst panelTitle = computed(() => {\n  const t = tool.value\n  const pt = t?.panelTitle\n  if (typeof pt === 'function') return pt(props.toolCall)\n  return pt ?? t?.label ?? props.toolCall.name\n})\n\n/** 未提供 render 时的兜底展示（面板工具通常都应提供 render） */\nconst fallbackResult = 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</script>\n"],"mappings":";;;;;;;;;;;;EAiCA,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,cAAkE;GACtE,SAAS;IAAE,MAAM;IAAS,OAAO;GAAY;GAC7C,SAAS;IAAE,MAAM;IAAS,OAAO;GAAY;GAC7C,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;;EAGtE,MAAM,aAAa,eAAe;GAChC,MAAM,IAAI,KAAK;GACf,MAAM,KAAK,GAAG;GACd,IAAI,OAAO,OAAO,YAAY,OAAO,GAAG,MAAM,QAAQ;GACtD,OAAO,MAAM,GAAG,SAAS,MAAM,SAAS;EAC1C,CAAC;;EAGD,MAAM,iBAAiB,eAAe;GACpC,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;;GAzEC,OAAA,UAAA,GAAA,mBAkBQ,SAAA,EAlBA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,OAAA,CAAA,EAAA,GAClB,CAAA,mBAgBM,OAAA,EAhBA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,CAAA,EAAA,GAChB,CAAA,mBAQM,OAAA,EARA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,cAAA,CAAA,EAAA,GAAA;IAChB,YAEQ,MAAA,KAAA,GAAA,EAFA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,GAAgB,YAAA,KAAW,CAAA,EAAA,GAAA;KAChB,SAAA,cAAA,EAAA,UAAA,GAA9B,YAA8B,wBAAd,WAAA,KAAU,CAAA,EAAA,CAAA;;;IAE5B,mBAA2D,QAAA,EAApD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,aAAA,CAAA,EAAA,GAAoB,gBAAA,WAAA,KAAU,GAAA,CAAA;IACjD,YAEQ,MAAA,KAAA,GAAA;KAFA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,aAAA,CAAA;KAAiB,OAAM;KAAQ,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,OAAA;;KACnD,SAAA,cAAA,CAAT,YAAS,MAAA,KAAA,CAAA,CAAA,CAAA;;;GAIb,GAAA,CAAA,GAAA,YAIU,MAAA,OAAA,GAAA,EAJA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,CAAA,EAAA,GAAA;IAC+C,SAAA,cAAA,CAAnE,mBAAA,8DAAA,GACmC,KAAA,OAAM,UAAA,UAAA,GAAzC,YAAyE,wBAAzD,KAAA,MAAK,MAAM,GAAA;;KAAuB,aAAW,QAAA;IAC7D,GAAA,MAAA,GAAA,CAAA,WAAA,CAAA,MAAA,UAAA,GAAA,mBAAuE,OAAA;;KAA1D,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA;IAAuB,GAAA,gBAAA,eAAA,KAAc,GAAA,CAAA,EAAA,CAAA"}
+{"version":3,"file":"side-panel.js","names":[],"sources":["../../../src/components/ai-chat/side-panel.vue"],"sourcesContent":["<template>\n  <aside :class=\"cls.e('panel')\">\n    <div :class=\"cls.e('panel-card')\">\n      <div :class=\"cls.e('panel-header')\">\n        <UIcon :class=\"[cls.e('panel-icon'), statusClass]\">\n          <component :is=\"headerIcon\" />\n        </UIcon>\n        <span :class=\"cls.e('panel-title')\">{{ panelTitle }}</span>\n        <UIcon :class=\"cls.e('panel-close')\" title=\"关闭面板\" @click=\"emit('close')\">\n          <Close />\n        </UIcon>\n      </div>\n\n      <UScroll :class=\"cls.e('panel-body')\">\n        <!-- render 组件与工具卡片同一契约（ChatToolRenderProps），可随 toolCall 状态实时更新 -->\n        <component :is=\"tool.render\" v-if=\"tool?.render\" :tool-call=\"toolCall\" />\n        <pre v-else :class=\"cls.e('panel-fallback')\">{{ fallbackResult }}</pre>\n      </UScroll>\n    </div>\n  </aside>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UIcon, UScroll } from '@veltra/desktop'\nimport { CircleCheckFilled, CircleClose, Close, Loading, WarningFilled } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { computed, inject, type Component } from 'vue'\n\nimport type { ChatToolCall } from '../../chat/types'\nimport { AiChatDIKey } from './di'\n\ndefineOptions({ name: 'UAiChatSidePanel' })\n\nconst props = defineProps<{ toolCall: ChatToolCall }>()\n\nconst emit = defineEmits<{ (e: 'close'): void }>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\n/** 当前调用对应的工具定义（解析 icon/label/render） */\nconst tool = computed(() => di?.tools.value[props.toolCall.name])\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/** 头部图标：工具自定义图标优先，缺省用状态图标（与工具卡片一致） */\nconst headerIcon = computed(() => tool.value?.icon ?? statusIcon.value)\n\n/** 面板标题：优先工具定义的 panelTitle（业务对象 + 动作），缺省回落到 label ?? name */\nconst panelTitle = computed(() => {\n  const t = tool.value\n  const pt = t?.panelTitle\n  if (typeof pt === 'function') return pt(props.toolCall)\n  return pt ?? t?.label ?? props.toolCall.name\n})\n\n/** 未提供 render 时的兜底展示（面板工具通常都应提供 render） */\nconst fallbackResult = 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</script>\n"],"mappings":";;;;;;;;;;;;EAiCA,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,cAAkE;GACtE,SAAS;IAAE,MAAM;IAAS,OAAO;GAAY;GAC7C,SAAS;IAAE,MAAM;IAAS,OAAO;GAAY;GAC7C,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;;EAGtE,MAAM,aAAa,eAAe;GAChC,MAAM,IAAI,KAAK;GACf,MAAM,KAAK,GAAG;GACd,IAAI,OAAO,OAAO,YAAY,OAAO,GAAG,MAAM,QAAQ;GACtD,OAAO,MAAM,GAAG,SAAS,MAAM,SAAS;EAC1C,CAAC;;EAGD,MAAM,iBAAiB,eAAe;GACpC,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;;GAzEC,OAAA,UAAA,GAAA,mBAkBQ,SAAA,EAlBA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,OAAA,CAAA,EAAA,GAClB,CAAA,mBAgBM,OAAA,EAhBA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,CAAA,EAAA,GAChB,CAAA,mBAQM,OAAA,EARA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,cAAA,CAAA,EAAA,GAAA;IAChB,YAEQ,MAAA,KAAA,GAAA,EAFA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,GAAgB,YAAA,KAAW,CAAA,EAAA,GAAA;KAC9C,SAAA,cAA8B,EAA9B,UAAA,GAAA,YAA8B,wBAAd,WAAA,KAAU,CAAA,EAAA,CAAA;;;IAE5B,mBAA2D,QAAA,EAApD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,aAAA,CAAA,EAAoB,GAAA,gBAAA,WAAA,KAAU,GAAA,CAAA;IACjD,YAEQ,MAAA,KAAA,GAAA;KAFA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,aAAA,CAAA;KAAiB,OAAM;KAAQ,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,OAAA;;KAC5D,SAAA,cAAS,CAAT,YAAS,MAAA,KAAA,CAAA,CAAA,CAAA;;;GAIb,GAAA,CAAA,GAAA,YAIU,MAAA,OAAA,GAAA,EAJA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,YAAA,CAAA,EAAA,GAAA;IACpB,SAAA,cAAmE,CAAnE,mBAAA,8DAAA,GACmC,KAAA,OAAM,UAAzC,UAAA,GAAA,YAAyE,wBAAzD,KAAA,MAAK,MAAM,GAAA;;KAAuB,aAAW,QAAA;IAC7D,GAAA,MAAA,GAAA,CAAA,WAAA,CAAA,MAAA,UAAA,GAAA,mBAAuE,OAAA;;KAA1D,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA;IAAuB,GAAA,gBAAA,eAAA,KAAc,GAAA,CAAA,EAAA,CAAA"}

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

@@ -5,6 +5,7 @@ import "@veltra/desktop/components/icon/style";
 import "@veltra/desktop/components/input/style";
 import "@veltra/desktop/components/layout/style";
 import "@veltra/desktop/components/message/style";
+import "@veltra/desktop/components/pop-confirm/style";
 import "@veltra/desktop/components/scroll/style";
 import "@veltra/desktop/components/select/style";
 import "@veltra/styles/animations/shine.scss";

package/dist/components/ai-chat/style.js

@@ -6,6 +6,7 @@ import "@veltra/desktop/components/icon/style";
 import "@veltra/desktop/components/input/style";
 import "@veltra/desktop/components/layout/style";
 import "@veltra/desktop/components/message/style";
+import "@veltra/desktop/components/pop-confirm/style";
 import "@veltra/desktop/components/scroll/style";
 import "@veltra/desktop/components/select/style";
 import "@veltra/styles/animations/shine.scss";

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

@@ -787,7 +787,6 @@
   font-size: var(--u-font-size-main-default);
   font-family: inherit;
   line-height: 1.6;
-  padding: var(--u-gap-small);
   box-sizing: border-box;
 }
 .u-ai-chat__input::placeholder {
@@ -807,7 +806,8 @@
   align-items: center;
   flex-wrap: nowrap;
   gap: var(--u-gap-small);
-  flex-shrink: 0;
+  flex: 1;
+  min-width: 0;
 }
 .u-ai-chat__input-toolbar-right {
   display: flex;
@@ -860,6 +860,32 @@
 .u-ai-chat__input-attach:hover {
   color: var(--u-color-primary);
 }
+.u-ai-chat__input-clear-wrap {
+  flex-shrink: 0;
+  display: inline-flex;
+  line-height: 0;
+}
+.u-ai-chat__input-clear-wrap.is-disabled {
+  opacity: 0.4;
+  pointer-events: none;
+}
+.u-ai-chat__input-clear {
+  color: var(--u-text-color-assist);
+  cursor: pointer;
+  font-size: 18px;
+}
+.u-ai-chat__input-clear:hover {
+  color: var(--u-color-danger);
+}
+.u-ai-chat__input-usage {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--u-font-size-main-small);
+  color: var(--u-text-color-assist);
+  line-height: 1.4;
+}
 .u-ai-chat__input-stop {
   display: block;
   width: 10px;

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    <!-- 自定义渲染：工具定义的 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":";;;;;;;;;;;;EAiEA,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;;EAG3B,MAAM,wBAAwB;GAC5B,cAAc;EAChB;;EAGA,MAAM,cAAc,eAAe,KAAK,OAAO,aAAa,OAAO;;EAGnE,MAAM,eAAe,eACb,KAAK,OAAO,iBAAiB,YAAY,SAAS,CAAC,KAAK,OAAO,OACvE;EAEA,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;GAAY;GAC7C,SAAS;IAAE,MAAM;IAAS,OAAO;GAAY;GAC7C,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,WAAW,eAAe;GAC9B,OAAO,MAAM,SAAS,WAAW,aAAa,MAAM,SAAS,WAAW;EAC1E,CAAC;;EAGD,MAAM,YAAY,eAAe;GAC/B,OAAO;IAAC;IAAW;IAAS;GAAU,CAAC,CAAC,SAAS,MAAM,SAAS,MAAM;EACxE,CAAC;;;;;EAMD,MAAM,oBAAoB,eAAe,UAAU,SAAS,CAAC,YAAY,KAAK;;EAG9E,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;;GAnLC,OAAA,UAAA,GAAA,YAkDgB,MAAA,aAAA,GAAA;IAjDL,YAAA,WAAA;IAAA,uBAAA,OAAA,OAAA,OAAA,MAAA,WAAA,WAAU,QAAA;IAClB,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,WAAA,GAAe,MAAA,GAAA,CAAG,CAAC,GAAG,QAAA,SAAS,MAAM,CAAA,CAAA;IAClD,uBAAqB,kBAAA;IACrB,UAAQ;;IAEE,QAAM,cAGP;KAFR,YAEQ,MAAA,KAAA,GAAA,EAFA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,kBAAA,GAAsB,YAAA,KAAW,CAAA,EAAA,GAAA;MACpD,SAAA,cAA8B,EAA9B,UAAA,GAAA,YAA8B,wBAAd,WAAA,KAAU,CAAA,EAAA,CAAA;;;KAE5B,mBAEO,QAAA,EAFA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,GAAoB,SAAA,SAAQ,SAAA,CAAA,EAC3C,GAAA,gBAAA,KAAA,OAAM,SAAS,QAAA,SAAS,IAAI,GAAA,CAAA;KAErB,QAAA,SAAZ,UAAA,GAAA,mBAA6E,QAAA;;MAAvD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA;KAA0B,GAAA,gBAAA,QAAA,KAAO,GAAA,CAAA,KAAA,mBAAA,QAAA,IAAA;KAG3D,QAAA,SAAS,WAAM,sBADvB,UAAA,GAAA,mBASO,QAAA;;MAPJ,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA;MACZ,SAAK,OAAA,OAAA,OAAA,KAAA,oBAAN,CAAA,GAAW,CAAA,MAAA,CAAA;MACV,WAAO,CAAR,OAAA,OAAA,OAAA,KAAA,SAAA,oBAAA,CAAA,GAAmB,CAAA,MAAA,CAAA,GAAA,CAAA,OAAA,CAAA,IACnB,OAAA,OAAA,OAAA,KAAA,SAAA,oBAAA,CAAA,GAAmB,CAAA,MAAA,CAAA,GAAA,CAAA,OAAA,CAAA,EAAA;KAEnB,GAAA,CAAA,YAAgF,MAAA,OAAA,GAAA;MAAvE,MAAK;MAAQ,MAAK;MAAW,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,WAAA,IAAA;;MAAmB,SAAA,cAAE,CAAA,GAAA,OAAA,OAAA,OAAA,KAAA,CAAF,gBAAA,MAAE,EAAA,CAAA,EAAA,CAAA;;KACtE,CAAA,GAAA,YAAuE,MAAA,OAAA,GAAA;MAA9D,MAAK;MAAQ,MAAA;MAAM,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,KAAI,WAAA,KAAA;;MAAoB,SAAA,cAAE,CAAA,GAAA,OAAA,OAAA,OAAA,KAAA,CAAF,gBAAA,MAAE,EAAA,CAAA,EAAA,CAAA;;;;IAKjE,SAAA,cAKM,CALK,YAAA,SAAX,UAAA,GAAA,mBAKM,OAAA;;KALmB,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,uBAAA,CAAA;IACnC,GAAA,CAAA,mBAA6D,QAAA,EAAtD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,sBAAA,CAAA,EAA0B,GAAA,aAAS,CAAA,GACtD,YAEU,MAAA,OAAA,GAAA;KAFD,MAAK;KAAQ,MAAA;KAAK,MAAK;KAAW,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,MAAA,EAAA,CAAE,EAAE,UAAU,QAAA,SAAS,EAAE;;KAAG,SAAA,cAE9E,CAAA,GAAA,OAAA,OAAA,OAAA,KAAA,CAF8E,gBAAA,UAE9E,EAAA,CAAA,EAAA,CAAA;;IAGsC,CAAA,CAAA,GAAA,CAAA,KAAA,KAAA,OAAM,UAA9C,UAAA,GAAA,mBAA8E,UAAA,EAAA,KAAA,EAAA,GAAA,CAD9E,mBAAA,oDAAA,IACA,UAAA,GAAA,YAA8E,wBAA9D,KAAA,MAAK,MAAM,GAAA,EAA4B,aAAW,QAAA,SAAQ,GAAA,MAAA,GAAA,CAAA,WAAA,CAAA,EAAA,GAAA,IACrC,KAAA,SAAA,SAAY,UAAA,SAAjD,UAAA,GAAA,YAA8D,wBAA9C,SAAA,KAAQ,GAAA,EAAA,KAAA,EAAA,CAAA,MACxB,UAAA,GAAA,mBAYW,UAAA,EAAA,KAAA,EAAA,GAAA,CAXO,gBAAA,SAAhB,UAAA,GAAA,mBAGW,UAAA,EAAA,KAAA,EAAA,GAAA,CAFT,mBAAiD,OAAA,EAA3C,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA,EAAuB,GAAA,MAAE,CAAA,GAC3C,mBAAiE,OAAA,EAA3D,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAuB,GAAA,gBAAA,gBAAA,KAAe,GAAA,CAAA,CAAA,GAAA,EAG1C,KAAA,mBAAA,QAAA,IAAA,GAAA,UAAA,SAAhB,UAAA,GAAA,mBAKW,UAAA,EAAA,KAAA,EAAA,GAAA,CAJT,mBAEM,OAAA,EAFA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,mBAAA,CAAA,EACb,GAAA,gBAAA,QAAA,SAAS,WAAM,UAAA,OAAA,IAAA,GAAA,CAAA,GAEpB,mBAA+D,OAAA,EAAzD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA,EAAuB,GAAA,gBAAA,cAAA,KAAa,GAAA,CAAA,CAAA,GAAA,EAAA,KAAA,mBAAA,QAAA,IAAA,CAAA,GAAA,EAAA,EAAA,CAAA"}

package/dist/components/ai-chat/turn-process.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-process.js","names":[],"sources":["../../../src/components/ai-chat/turn-process.vue"],"sourcesContent":["<template>\n  <div :class=\"[cls.e('process'), bem.is('expanded', expanded)]\">\n    <div :class=\"cls.e('process-header')\" @click=\"expanded = !expanded\">\n      <UIcon :class=\"cls.e('process-icon')\"><CircleCheck /></UIcon>\n      <span :class=\"cls.e('process-title')\">已完成</span>\n      <UIcon :class=\"cls.e('process-chevron')\"><ArrowRight /></UIcon>\n    </div>\n    <!-- 折叠时完全卸载过程 DOM：历史轮次的思考/工具卡片可能很多，常驻挂载浪费渲染成本 -->\n    <div v-if=\"expanded\" :class=\"cls.e('process-content')\">\n      <MessageItem\n        v-for=\"msg in messages\"\n        :key=\"msg.id\"\n        :message=\"msg\"\n        :is-last=\"false\"\n        :renderer-props=\"rendererProps\"\n        @respond=\"(id, approved) => emit('respond', id, approved)\"\n      />\n    </div>\n  </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UIcon } from '@veltra/desktop'\nimport { ArrowRight, CircleCheck } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { inject, ref } from 'vue'\n\nimport type { ChatMessage } from '../../chat/types'\nimport { AiChatDIKey } from './di'\nimport MessageItem from './message-item.vue'\n\ndefineOptions({ name: 'UAiChatTurnProcess' })\n\ndefineProps<{\n  /** 本轮最终答案之前的过程消息（思考 + 中间文本 + 工具卡片） */\n  messages: ChatMessage[]\n  /** 透传给 MarkdownRender 的属性 */\n  rendererProps?: Record<string, unknown>\n}>()\n\nconst emit = defineEmits<{ (e: 'respond', toolCallId: string, approved: boolean): void }>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\nconst expanded = ref(false)\n</script>\n"],"mappings":";;;;;;;;;;;;;;;;EAwCA,MAAM,OAAO;EAGb,MAAM,MADK,OAAO,WACN,CAAA,EAAI,OAAO,IAAI,SAAS;EAEpC,MAAM,WAAW,IAAI,KAAK;;GA5CxB,OAAA,UAAA,GAAA,mBAiBM,OAAA,EAjBA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,SAAA,GAAa,MAAA,GAAA,CAAG,CAAC,GAAE,YAAa,SAAA,KAAQ,CAAA,CAAA,EAAA,GAAA;IACzD,mBAIM,OAAA;KAJA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA;KAAqB,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,SAAA,QAAQ,CAAI,SAAA;;KACxD,YAA6D,MAAA,KAAA,GAAA,EAArD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,cAAA,CAAA,EAAA,GAAA;MAAiC,SAAA,cAAA,CAAf,YAAe,MAAA,WAAA,CAAA,CAAA,CAAA;;;KACrD,mBAAgD,QAAA,EAAzC,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,eAAA,CAAA,EAAA,GAAmB,OAAG,CAAA;KACzC,YAA+D,MAAA,KAAA,GAAA,EAAvD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,iBAAA,CAAA,EAAA,GAAA;MAAmC,SAAA,cAAA,CAAd,YAAc,MAAA,UAAA,CAAA,CAAA,CAAA;;;;IAEzD,mBAAA,6CAAA;IACW,SAAA,SAAA,UAAA,GAAX,mBASM,OAAA;;KATgB,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,iBAAA,CAAA;IAChC,GAAA,EAAA,UAAA,IAAA,GAAA,mBAOE,UAAA,MAAA,WANc,QAAA,WAAP,QAAG;KADZ,OAAA,UAAA,GAAA,YAOE,aAAA;MALC,KAAK,IAAI;MACT,SAAS;MACT,WAAS;MACT,kBAAgB,QAAA;MAChB,WAAO,OAAA,OAAA,OAAA,MAAG,IAAI,aAAa,KAAI,WAAY,IAAI,QAAQ"}
+{"version":3,"file":"turn-process.js","names":[],"sources":["../../../src/components/ai-chat/turn-process.vue"],"sourcesContent":["<template>\n  <div :class=\"[cls.e('process'), bem.is('expanded', expanded)]\">\n    <div :class=\"cls.e('process-header')\" @click=\"expanded = !expanded\">\n      <UIcon :class=\"cls.e('process-icon')\"><CircleCheck /></UIcon>\n      <span :class=\"cls.e('process-title')\">已完成</span>\n      <UIcon :class=\"cls.e('process-chevron')\"><ArrowRight /></UIcon>\n    </div>\n    <!-- 折叠时完全卸载过程 DOM：历史轮次的思考/工具卡片可能很多，常驻挂载浪费渲染成本 -->\n    <div v-if=\"expanded\" :class=\"cls.e('process-content')\">\n      <MessageItem\n        v-for=\"msg in messages\"\n        :key=\"msg.id\"\n        :message=\"msg\"\n        :is-last=\"false\"\n        :renderer-props=\"rendererProps\"\n        @respond=\"(id, approved) => emit('respond', id, approved)\"\n      />\n    </div>\n  </div>\n</template>\n\n<script lang=\"ts\" setup>\nimport { UIcon } from '@veltra/desktop'\nimport { ArrowRight, CircleCheck } from '@veltra/icons/normal'\nimport { bem } from '@veltra/utils'\nimport { inject, ref } from 'vue'\n\nimport type { ChatMessage } from '../../chat/types'\nimport { AiChatDIKey } from './di'\nimport MessageItem from './message-item.vue'\n\ndefineOptions({ name: 'UAiChatTurnProcess' })\n\ndefineProps<{\n  /** 本轮最终答案之前的过程消息（思考 + 中间文本 + 工具卡片） */\n  messages: ChatMessage[]\n  /** 透传给 MarkdownRender 的属性 */\n  rendererProps?: Record<string, unknown>\n}>()\n\nconst emit = defineEmits<{ (e: 'respond', toolCallId: string, approved: boolean): void }>()\n\nconst di = inject(AiChatDIKey)\nconst cls = di?.cls ?? bem('ai-chat')\n\nconst expanded = ref(false)\n</script>\n"],"mappings":";;;;;;;;;;;;;;;;EAwCA,MAAM,OAAO;EAGb,MAAM,MADK,OAAO,WACN,CAAA,EAAI,OAAO,IAAI,SAAS;EAEpC,MAAM,WAAW,IAAI,KAAK;;GA5CxB,OAAA,UAAA,GAAA,mBAiBM,OAAA,EAjBA,OAAK,eAAA,CAAG,MAAA,GAAA,CAAG,CAAC,EAAC,SAAA,GAAa,MAAA,GAAA,CAAG,CAAC,GAAE,YAAa,SAAA,KAAQ,CAAA,CAAA,EAAA,GAAA;IACzD,mBAIM,OAAA;KAJA,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,gBAAA,CAAA;KAAqB,SAAK,OAAA,OAAA,OAAA,MAAA,WAAE,SAAA,QAAQ,CAAI,SAAA;;KACxD,YAA6D,MAAA,KAAA,GAAA,EAArD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,cAAA,CAAA,EAAA,GAAA;MAAkB,SAAA,cAAe,CAAf,YAAe,MAAA,WAAA,CAAA,CAAA,CAAA;;;KACrD,mBAAgD,QAAA,EAAzC,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,eAAA,CAAA,EAAmB,GAAA,OAAG,CAAA;KACzC,YAA+D,MAAA,KAAA,GAAA,EAAvD,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,iBAAA,CAAA,EAAA,GAAA;MAAqB,SAAA,cAAc,CAAd,YAAc,MAAA,UAAA,CAAA,CAAA,CAAA;;;;IAEzD,mBAAA,6CAAA;IACW,SAAA,SAAX,UAAA,GAAA,mBASM,OAAA;;KATgB,OAAK,eAAE,MAAA,GAAA,CAAG,CAAC,EAAC,iBAAA,CAAA;IAChC,GAAA,EAAA,UAAA,IAAA,GAAA,mBAOE,UAAA,MAAA,WANc,QAAA,WAAP,QAAG;KADZ,OAAA,UAAA,GAAA,YAOE,aAAA;MALC,KAAK,IAAI;MACT,SAAS;MACT,WAAS;MACT,kBAAgB,QAAA;MAChB,WAAO,OAAA,OAAA,OAAA,MAAG,IAAI,aAAa,KAAI,WAAY,IAAI,QAAQ"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus } from "./chat/types.js";
+import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatToolContext, ChatToolRenderProps, ChatTransport, ChatTransportHandlers, ChatTransportRequest, ToolCallStatus } from "./chat/types.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";
@@ -10,4 +10,4 @@ import { OpenAITransport, OpenAITransportOptions, createOpenAITransport } from "
 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, 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, 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 };

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

@@ -1,4 +1,4 @@
-import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTool, ChatToolCall, ChatTransport } from "../chat/types.js";
+import { ChatAttachment, ChatMessage, ChatQueuedMessage, ChatTokenUsage, ChatTool, ChatToolCall, ChatTransport } from "../chat/types.js";
 import { ChatModelOption } from "../providers/types.js";
 import { Ref } from "vue";
 import { DeconstructValue } from "@veltra/utils";
@@ -36,6 +36,11 @@ interface AiChatProps {
   maxAttachmentSize?: number;
   /** 透传给内部 MarkdownRender 的属性 */
   rendererProps?: Record<string, unknown>;
+  /**
+   * 是否展示 token 用量明细（缓存命中 / 未命中；缺字段不显示）。
+   * 默认 false：仅在拿到 usage 时显示会话累计「总 token」。接口未返回 usage 时不展示。
+   */
+  tokenUsageDetail?: boolean;
 }
 interface AiChatEmits {
   /** 消息列表变化 */
@@ -60,8 +65,12 @@ interface _AiChatExposed {
   abort: () => void;
   /** 重新生成最后一条 assistant 回复 */
   regenerate: () => void;
-  /** 清空消息与待发送队列 */
+  /** 清空消息、待发送队列与 token 统计（生成中会先中止） */
   clear: () => void;
+  /** 当前会话累计 token（从未收到 usage 时为 null） */
+  tokenUsage: Ref<ChatTokenUsage | null>;
+  /** 最近一轮用户对话的 token（含工具多轮请求；该轮无 usage 时为 null） */
+  lastTurnUsage: Ref<ChatTokenUsage | null>;
   /** 待发送消息队列（会话进行中提交的消息按序排队，收尾后 FIFO 自动接续） */
   queue: Ref<ChatQueuedMessage[]>;
   /** 立即执行队列中的某条：中断当前会话并插队为下一条 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/ai",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"

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

@@ -375,6 +375,8 @@ describe('useChat', () => {
 
     expect(chat.messages.value).toHaveLength(0)
     expect(chat.queue.value).toHaveLength(0)
+    expect(chat.tokenUsage.value).toBeNull()
+    expect(chat.lastTurnUsage.value).toBeNull()
   })
 
   it('请求携带 model 与 reasoningLevel', async () => {
@@ -567,4 +569,69 @@ describe('useChat', () => {
     // 最终同步给父级的快照也包含 assistant 消息
     expect(props.messages?.some((m) => m.role === 'assistant' && m.content === '回答')).toBe(true)
   })
+
+  it('累计 onUsage，无 usage 时保持 null；clear 一并重置', 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}' })
+        handlers.onUsage?.({
+          promptTokens: 10,
+          completionTokens: 4,
+          totalTokens: 14,
+          cacheHitTokens: 6,
+          cacheMissTokens: 4
+        })
+      } else {
+        handlers.onTextDelta('3')
+        handlers.onUsage?.({
+          promptTokens: 20,
+          completionTokens: 2,
+          totalTokens: 22,
+          cacheHitTokens: 12,
+          cacheMissTokens: 8
+        })
+      }
+    }
+    const tools: ChatTool[] = [
+      { name: 'add', description: '加法', parameters: {}, execute: () => 3 }
+    ]
+    const chat = useChat({ props: { transport, tools }, emit })
+
+    expect(chat.tokenUsage.value).toBeNull()
+    chat.send('算一下')
+    await waitFinish(emit)
+
+    expect(chat.lastTurnUsage.value).toEqual({
+      promptTokens: 30,
+      completionTokens: 6,
+      totalTokens: 36,
+      cacheHitTokens: 18,
+      cacheMissTokens: 12
+    })
+    expect(chat.tokenUsage.value).toEqual(chat.lastTurnUsage.value)
+
+    chat.send('再算')
+    await vi.waitFor(() => {
+      expect(emit.mock.calls.filter((call) => call[0] === 'finish')).toHaveLength(2)
+    })
+    expect(chat.lastTurnUsage.value?.totalTokens).toBe(22)
+    expect(chat.tokenUsage.value?.totalTokens).toBe(58)
+    expect(chat.tokenUsage.value?.cacheHitTokens).toBe(30)
+
+    chat.clear()
+    expect(chat.tokenUsage.value).toBeNull()
+    expect(chat.lastTurnUsage.value).toBeNull()
+  })
+
+  it('transport 不回调 onUsage 时不编造数字', async () => {
+    const emit = createEmit()
+    const chat = useChat({ props: { transport: textTransport('ok') }, emit })
+    chat.send('hi')
+    await waitFinish(emit)
+    expect(chat.tokenUsage.value).toBeNull()
+    expect(chat.lastTurnUsage.value).toBeNull()
+  })
 })

package/src/chat/transports/__test__/openai.test.ts

@@ -7,6 +7,7 @@ const baseHandlers = (): ChatTransportHandlers => ({
   onTextDelta: vi.fn(),
   onReasoningDelta: vi.fn(),
   onToolCall: vi.fn(),
+  onUsage: vi.fn(),
   onError: vi.fn()
 })
 
@@ -314,4 +315,143 @@ data: [DONE]
       arguments: '{"y":2}'
     })
   })
+
+  it('请求体带 stream_options.include_usage', async () => {
+    const fetchMock = vi.fn(async () => {
+      return new Response('data: [DONE]\n\n', {
+        status: 200,
+        headers: { 'Content-Type': 'text/event-stream' }
+      })
+    })
+    vi.stubGlobal('fetch', fetchMock)
+
+    const transport = createOpenAITransport({
+      providers: [{ id: 'a', endpoint: 'https://a.example/chat', models: [{ id: 'm' }] }]
+    })
+    await transport(
+      {
+        messages: [{ id: '1', role: 'user', content: 'hi' }],
+        signal: new AbortController().signal
+      },
+      baseHandlers()
+    )
+
+    expect(JSON.parse(String(fetchMock.mock.calls[0]![1]!.body))).toMatchObject({
+      stream: true,
+      stream_options: { include_usage: true }
+    })
+  })
+
+  it('解析末包 usage，含缓存命中 / 未命中，无 usage 不回调', async () => {
+    const sse = String.raw`data: {"choices":[{"delta":{"content":"hi"}}]}
+
+data: {"choices":[],"usage":{"prompt_tokens":12,"completion_tokens":3,"total_tokens":15,"prompt_tokens_details":{"cached_tokens":8},"prompt_cache_hit_tokens":8,"prompt_cache_miss_tokens":4}}
+
+data: [DONE]
+`
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(async () => new Response(sse, { status: 200 }))
+    )
+
+    const transport = createOpenAITransport({
+      providers: [{ id: 'a', endpoint: 'https://a.example/chat', models: [{ id: 'm' }] }]
+    })
+    const handlers = baseHandlers()
+    await transport(
+      {
+        messages: [{ id: '1', role: 'user', content: 'hi' }],
+        signal: new AbortController().signal
+      },
+      handlers
+    )
+
+    expect(handlers.onTextDelta).toHaveBeenCalledWith('hi')
+    expect(handlers.onUsage).toHaveBeenCalledTimes(1)
+    expect(handlers.onUsage).toHaveBeenCalledWith({
+      promptTokens: 12,
+      completionTokens: 3,
+      totalTokens: 15,
+      cacheHitTokens: 8,
+      cacheMissTokens: 4
+    })
+  })
+
+  it('仅有 cached_tokens 时由 prompt − 命中得到未命中；缺 usage 不编造', async () => {
+    const withCache = String.raw`data: {"choices":[{"delta":{"content":"a"}}],"usage":{"prompt_tokens":10,"completion_tokens":1,"total_tokens":11,"prompt_tokens_details":{"cached_tokens":7}}}
+
+data: [DONE]
+`
+    const noUsage = String.raw`data: {"choices":[{"delta":{"content":"b"}}]}
+
+data: [DONE]
+`
+    const fetchMock = vi
+      .fn()
+      .mockResolvedValueOnce(new Response(withCache, { status: 200 }))
+      .mockResolvedValueOnce(new Response(noUsage, { status: 200 }))
+    vi.stubGlobal('fetch', fetchMock)
+
+    const transport = createOpenAITransport({
+      providers: [{ id: 'a', endpoint: 'https://a.example/chat', models: [{ id: 'm' }] }]
+    })
+
+    const withCacheHandlers = baseHandlers()
+    await transport(
+      {
+        messages: [{ id: '1', role: 'user', content: 'hi' }],
+        signal: new AbortController().signal
+      },
+      withCacheHandlers
+    )
+    expect(withCacheHandlers.onUsage).toHaveBeenCalledWith({
+      promptTokens: 10,
+      completionTokens: 1,
+      totalTokens: 11,
+      cacheHitTokens: 7,
+      cacheMissTokens: 3
+    })
+
+    const noUsageHandlers = baseHandlers()
+    await transport(
+      {
+        messages: [{ id: '1', role: 'user', content: 'hi' }],
+        signal: new AbortController().signal
+      },
+      noUsageHandlers
+    )
+    expect(noUsageHandlers.onUsage).not.toHaveBeenCalled()
+  })
+
+  it('解析 Anthropic 风格 cache_read / cache_creation', async () => {
+    const sse = String.raw`data: {"choices":[{"delta":{"content":"ok"}}],"usage":{"prompt_tokens":20,"completion_tokens":2,"total_tokens":22,"cache_read_input_tokens":15,"cache_creation_input_tokens":3}}
+
+data: [DONE]
+`
+    vi.stubGlobal(
+      'fetch',
+      vi.fn(async () => new Response(sse, { status: 200 }))
+    )
+
+    const transport = createOpenAITransport({
+      providers: [{ id: 'a', endpoint: 'https://a.example/chat', models: [{ id: 'm' }] }]
+    })
+    const handlers = baseHandlers()
+    await transport(
+      {
+        messages: [{ id: '1', role: 'user', content: 'hi' }],
+        signal: new AbortController().signal
+      },
+      handlers
+    )
+
+    expect(handlers.onUsage).toHaveBeenCalledWith({
+      promptTokens: 20,
+      completionTokens: 2,
+      totalTokens: 22,
+      cacheHitTokens: 15,
+      cacheMissTokens: 5,
+      cacheCreationTokens: 3
+    })
+  })
 })

package/src/chat/transports/openai.ts

@@ -1,6 +1,7 @@
 import type { ChatModelOption, ChatProvider } from '../../providers'
 import type {
   ChatMessage,
+  ChatTokenUsage,
   ChatTool,
   ChatTransport,
   ChatTransportHandlers,
@@ -82,6 +83,58 @@ interface AccumulatedToolCall {
   arguments: string
 }
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+/** 非负有限整数；非法或缺省返回 undefined（不把缺失当成 0） */
+function readCount(value: unknown): number | undefined {
+  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) return undefined
+  return Math.floor(value)
+}
+
+/**
+ * 从 OpenAI 兼容 usage 对象解析。
+ * 缓存字段只在源数据出现时写入；未命中可在「有命中 + prompt」时由差值得出。
+ */
+function parseOpenAIUsage(raw: unknown): ChatTokenUsage | null {
+  if (!isRecord(raw)) return null
+
+  const promptTokens = readCount(raw.prompt_tokens) ?? readCount(raw.input_tokens)
+  const completionTokens = readCount(raw.completion_tokens) ?? readCount(raw.output_tokens)
+  if (promptTokens == null && completionTokens == null) return null
+
+  const prompt = promptTokens ?? 0
+  const completion = completionTokens ?? 0
+  const usage: ChatTokenUsage = {
+    promptTokens: prompt,
+    completionTokens: completion,
+    totalTokens: readCount(raw.total_tokens) ?? prompt + completion
+  }
+
+  const details = isRecord(raw.prompt_tokens_details) ? raw.prompt_tokens_details : undefined
+  const inputDetails = isRecord(raw.input_tokens_details) ? raw.input_tokens_details : undefined
+  const cacheHitTokens =
+    readCount(details?.cached_tokens) ??
+    readCount(inputDetails?.cached_tokens) ??
+    readCount(raw.prompt_cache_hit_tokens) ??
+    readCount(raw.cache_read_input_tokens) ??
+    readCount(raw.cached_tokens)
+  if (cacheHitTokens != null) usage.cacheHitTokens = cacheHitTokens
+
+  const cacheMissTokens =
+    readCount(raw.prompt_cache_miss_tokens) ??
+    (cacheHitTokens != null && promptTokens != null
+      ? Math.max(0, promptTokens - cacheHitTokens)
+      : undefined)
+  if (cacheMissTokens != null) usage.cacheMissTokens = cacheMissTokens
+
+  const cacheCreationTokens = readCount(raw.cache_creation_input_tokens)
+  if (cacheCreationTokens != null) usage.cacheCreationTokens = cacheCreationTokens
+
+  return usage
+}
+
 /**
  * 逐行解析 SSE 流。
  * 兼容 OpenAI 及 DeepSeek 等 reasoning_content 风格的兼容端点。
@@ -112,15 +165,21 @@ async function parseSSE(
   const handleData = (data: string) => {
     if (data === '[DONE]') return
 
-    let chunk: any
+    let chunk: unknown
     try {
       chunk = JSON.parse(data)
     } catch {
       return
     }
+    if (!isRecord(chunk)) return
+
+    const usage = parseOpenAIUsage(chunk.usage)
+    if (usage) handlers.onUsage?.(usage)
 
-    const delta = chunk.choices?.[0]?.delta
-    if (!delta) return
+    const choices = chunk.choices
+    const first = Array.isArray(choices) ? choices[0] : undefined
+    const delta = isRecord(first) ? first.delta : undefined
+    if (!isRecord(delta)) return
 
     if (typeof delta.content === 'string' && delta.content) {
       handlers.onTextDelta(delta.content)
@@ -134,7 +193,8 @@ async function parseSSE(
 
     if (Array.isArray(delta.tool_calls)) {
       for (const tc of delta.tool_calls) {
-        const index: number = tc.index ?? 0
+        if (!isRecord(tc)) continue
+        const index = typeof tc.index === 'number' ? tc.index : 0
         // 同一调用的参数分片共享 index；index 变大才说明前一个调用已完整，先抛出去
         if (index > lastIndex && accumulated.size > 0) flushToolCalls()
         lastIndex = Math.max(lastIndex, index)
@@ -144,9 +204,10 @@ async function parseSSE(
           call = { id: '', name: '', arguments: '' }
           accumulated.set(index, call)
         }
-        if (tc.id) call.id = tc.id
-        if (tc.function?.name) call.name += tc.function.name
-        if (tc.function?.arguments) call.arguments += tc.function.arguments
+        if (typeof tc.id === 'string') call.id = tc.id
+        const fn = isRecord(tc.function) ? tc.function : undefined
+        if (typeof fn?.name === 'string') call.name += fn.name
+        if (typeof fn?.arguments === 'string') call.arguments += fn.arguments
       }
     }
   }
@@ -240,10 +301,15 @@ export function createOpenAITransport(options: OpenAITransportOptions): OpenAITr
       return
     }
 
+    const extraStreamOptions = isRecord(globalBody?.stream_options)
+      ? globalBody.stream_options
+      : undefined
     const requestBody: Record<string, unknown> = {
       ...globalBody,
       model: modelId,
       stream: true,
+      // 流式默认要末包 usage；OpenAI / DeepSeek 等兼容端点靠这个字段才会返回
+      stream_options: { ...extraStreamOptions, include_usage: true },
       messages: toOpenAIMessages(messages, systemPrompt),
       ...(tools?.length ? { tools: toOpenAITools(tools) } : {})
     }

package/src/chat/types.ts

@@ -151,6 +151,32 @@ export interface ChatTransportRequest {
   signal: AbortSignal
 }
 
+/**
+ * 一次模型请求的 token 用量。
+ * 仅包含接口实际返回的字段；缓存类数字缺省为 undefined，不补 0。
+ */
+export interface ChatTokenUsage {
+  /** 输入 token */
+  promptTokens: number
+  /** 输出 token */
+  completionTokens: number
+  /** 合计 token */
+  totalTokens: number
+  /**
+   * 缓存命中。
+   * 来源：`prompt_tokens_details.cached_tokens` / `prompt_cache_hit_tokens` /
+   * `cache_read_input_tokens` / `cached_tokens`。
+   */
+  cacheHitTokens?: number
+  /**
+   * 缓存未命中。
+   * 来源：`prompt_cache_miss_tokens`；若无该字段但有命中与 prompt，则为 prompt − 命中。
+   */
+  cacheMissTokens?: number
+  /** 写入缓存（Anthropic 风格 `cache_creation_input_tokens`），有才有 */
+  cacheCreationTokens?: number
+}
+
 /** transport 流式事件回调 */
 export interface ChatTransportHandlers {
   /** 文本增量 */
@@ -162,6 +188,11 @@ export interface ChatTransportHandlers {
    * 流式参数片段由 transport 内部累积，参数完整后才通过该回调抛出。
    */
   onToolCall?(call: { id: string; name: string; arguments: string }): void
+  /**
+   * 本次请求的 token 用量（流式末包或非流式 usage）。
+   * 接口未返回 usage 时不要调用，不要填 0 充数。
+   */
+  onUsage?(usage: ChatTokenUsage): void
   /** 请求错误 */
   onError?(error: Error): void
 }