@blueking/chat-x 0.0.45-beta.7 → 0.0.45-beta.8

package/README.md

@@ -458,7 +458,7 @@ CSS 变量 + `useGlobalConfig` 统一调整全局展示配置。
 
 | 工具                | 说明                                        |
 | ------------------- | ------------------------------------------- |
-| `list_components`   | 列出所有组件，支持按 domain / category 过滤 |
+| `list_components`   | 列出所有索引条目，支持按 kind / domain 过滤 |
 | `get_component_doc` | 获取指定组件文档，含 AI 摘要                |
 | `search_docs`       | 关键词搜索文档                              |
 

package/dist/ag-ui/types/constants.d.ts

@@ -1,3 +1,17 @@
+export declare enum APPROVAL_STATUS {
+    ABANDONED = "abandoned",// 已废弃
+    APPROVED = "approved",// 已批准
+    CANCELLED = "cancelled",// 已取消
+    DRAFT = "draft",// 草稿 - 待审批
+    EXPIRED = "expired",// 已过期
+    PENDING = "pending",// 待审批
+    REJECTED = "rejected",// 已拒绝
+    REVOKED = "revoked"
+}
+export declare enum InterruptReason {
+    AIDevToolApproval = "aidev:tool_approval",// AI dev 第三方审批
+    UserQuestion = "aidev:user_question"
+}
 export declare enum MessageContentType {
     Binary = "binary",
     FlowAgent = "flow_agent",
@@ -19,6 +33,7 @@ export declare enum MessageRole {
     HiddenSystem = "hidden-system",
     HiddenUser = "hidden-user",
     Info = "info",
+    Interrupt = "interrupt",
     Loading = "loading",
     Pause = "pause",
     Placeholder = "placeholder",
@@ -43,3 +58,4 @@ export declare enum MessageStatus {
     Streaming = "streaming",
     Success = "success"
 }
+export declare const APPROVAL_STATUS_MAP: Record<APPROVAL_STATUS, string>;

package/dist/ag-ui/types/contents.d.ts

@@ -43,7 +43,9 @@ export type BkFlowNode = {
     loop: number;
     name: string;
     retry: number;
+    retryable?: boolean;
     skip: boolean;
+    skippable?: boolean;
     start_time: string;
     state: string;
     type: string;

package/dist/ag-ui/types/index.d.ts

@@ -1,3 +1,5 @@
 export * from './constants';
 export * from './contents';
+export * from './interrupt';
 export * from './messages';
+export * from './schema';

package/dist/ag-ui/types/interrupt.d.ts

@@ -0,0 +1,152 @@
+import type { APPROVAL_STATUS, InterruptReason, MessageRole } from './constants';
+import type { BaseMessage } from './messages';
+/**
+ * 可恢复操作（resume operation）枚举。
+ *
+ * 统一标识用户在「中断消息 / 活动消息」上触发的、需回传 Agent 处理的动作；
+ * 业务侧通过 `onInterruptResume` 回调的 `payload.operation` 字段进行分支处理。
+ * 新增操作类型只需在此扩展，回调契约与透传链路保持不变。
+ */
+export declare enum InterruptResumeOperation {
+    /** 主动取消第三方工具审批：在 interrupt 记录上写入取消结果 */
+    ApprovalCancel = "approval_cancel",
+    /** 重试失败的流程节点：bkflow 节点状态重置为可执行 */
+    FlowNodeRetry = "flow_node_retry",
+    /** 跳过失败的流程节点：bkflow 节点标记为已跳过 */
+    FlowNodeSkip = "flow_node_skip"
+}
+/**
+ * AI Dev 第三方工具审批中断
+ */
+export type AIDevToolApprovalInterrupt = BaseInterrupt<InterruptReason.AIDevToolApproval, AIDevToolApprovalInterruptPayloadMetaData>;
+export type AIDevToolApprovalInterruptPayloadMetaData = {
+    ticket: {
+        approvers: string[];
+        sn: string;
+        status: APPROVAL_STATUS;
+        submit_time: string;
+        title: string;
+        url: string;
+    };
+};
+/**
+ * AI Dev 第三方工具审批中断响应（resume 后用于 outcome.success 时会话内回显审批单）。
+ * payload 透传中断时的 metaData（含 ticket），以便复用 ToolApprovalCard 渲染。
+ */
+export type AIDevToolApprovalResume = BaseResume<InterruptReason.AIDevToolApproval, {
+    metadata: AIDevToolApprovalInterruptPayloadMetaData;
+}>;
+export type BaseInterrupt<T extends InterruptReason, M extends Record<string, any>> = {
+    expiresAt?: string;
+    id: string;
+    message?: string;
+    metadata?: M;
+    properties?: Record<string, any>;
+    reason: T;
+    toolCallId: string;
+};
+export type BaseResume<T extends InterruptReason, P extends Record<string, any> = Record<string, any>> = {
+    id?: string;
+    interruptId: string;
+    payload: P;
+    reason: T;
+    status: 'cancelled' | 'resolved';
+};
+/**
+ * 流程节点（flow-agent）操作响应负载：重试 / 跳过失败节点。
+ * 流程节点不属于 interrupt，故节点定位信息（taskId / nodeId）随 payload 一并回传，
+ * 此时 `onInterruptResume` 的第二个 `interrupt` 参数为空。
+ */
+export type FlowNodeResume = {
+    operation: InterruptResumeOperation.FlowNodeRetry | InterruptResumeOperation.FlowNodeSkip;
+    payload: {
+        node_id: string;
+        task_id: number;
+    };
+};
+export type Interrupt = AIDevToolApprovalInterrupt | BaseInterrupt<InterruptReason, Record<string, any>> | UserQuestionInterrupt;
+export type InterruptItem = Interrupt;
+/**
+ * 中断消息
+ *
+ * 对应 AG-UI 协议 `RUN_FINISHED { outcome: { type: "interrupt", interrupts } }` 事件。
+ * 当 Agent 需要 human-in-the-loop（审批 / 补充信息 / 策略阻断等）时，
+ * 会派生此类型消息以驱动 UI 渲染等待用户响应；用户响应后通过
+ * `RunAgentInput.resume = { interruptId, payload }` 把结果回传给 Agent。
+ *
+ * @see https://docs.ag-ui.com/drafts/interrupts
+ */
+export type InterruptMessage = BaseMessage<MessageRole.Interrupt, {
+    message?: string;
+    /** 是否已被用户响应（resume）过，用于 UI 区分"等待响应 / 已处理"两种态 */
+    outcome?: RunFinishedOutcome;
+    /** outcome.type === success 用户 resume 后回传/持久化的结果，用于会话内按 reason 回显 */
+    result?: InterruptResult;
+    runId?: string;
+    threadId?: string;
+}>;
+/**
+ * 中断处理结果（resume 后回传/持久化，用于 outcome.success 时会话内回显）。
+ * 按 reason 区分不同结果形态，统一具备 BaseResume 的 { interruptId, reason, status }；
+ * 新增中断类型的回显结果只需在此联合扩展。
+ */
+export type InterruptResult = AIDevToolApprovalResume | UserQuestionResume;
+export type InterruptResume = FlowNodeResume | ToolApprovalResume | UserQuestionResume;
+/**
+ * 中断响应回调（统一约定：payload 在前，原始中断信息在后）
+ * @param payload 响应负载（resume payload），通过 `payload.operation` 区分动作类型
+ * @param interrupt 中断原始信息；流程节点等非中断来源的操作可不传
+ * @returns
+ */
+export type OnInterruptResume = (payload: InterruptResume, interrupt?: Interrupt) => Promise<void> | void;
+export type RunFinishedOutcome = {
+    interrupts: Interrupt[];
+    type: 'interrupt';
+} | {
+    type: 'success';
+};
+/**
+ * 第三方工具审批中断的响应负载（取消审批等动作）
+ */
+export type ToolApprovalResume = {
+    operation: InterruptResumeOperation.ApprovalCancel;
+    payload: {
+        interrupt_id: number | string;
+    };
+};
+/**
+ * 用户对单个问题的回答
+ */
+export type UserQuestionAnswerItem = {
+    answer: UserQuestionOptionItem[];
+    multiSelect?: boolean;
+    question: string;
+};
+/**
+ * 用户回答问题中断
+ */
+export type UserQuestionInterrupt = BaseInterrupt<InterruptReason.UserQuestion, {
+    questions: UserQuestionItem[];
+}>;
+/**
+ * 用户回答问题中的单个问题
+ */
+export type UserQuestionItem = {
+    header: string;
+    multiSelect?: boolean;
+    options?: UserQuestionOptionItem[];
+    question: string;
+};
+/**
+ * 用户回答问题选项；label 为 `others` 时代表用户自定义输入，description 为输入文本
+ */
+export type UserQuestionOptionItem = {
+    description: string;
+    label: string;
+};
+/**
+ * 用户回答问题中断响应
+ */
+export type UserQuestionResume = BaseResume<InterruptReason.UserQuestion, {
+    answers: UserQuestionAnswerItem[];
+}>;

package/dist/ag-ui/types/messages.d.ts

@@ -1,6 +1,7 @@
 import type { OldShortcut, Shortcut } from '../../types';
 import type { MessageContentType, MessageRole, MessageStatus } from './constants';
 import type { ContentMap, InputContent } from './contents';
+import type { InterruptMessage } from './interrupt';
 export interface ActivityMessage extends BaseMessage<MessageRole.Activity, ContentMap[MessageContentType.FlowAgent] | ContentMap[MessageContentType.KnowledgeRag] | ContentMap[MessageContentType.ReferenceDocument]> {
     activityType: MessageContentType.FlowAgent | MessageContentType.KnowledgeRag | MessageContentType.ReferenceDocument | string;
 }
@@ -73,6 +74,7 @@ export type MessageMap = AIBluekingMessageMap & {
     [MessageRole.HiddenSystem]: HiddenSystemMessage;
     [MessageRole.HiddenUser]: HiddenUserMessage;
     [MessageRole.Info]: InfoMessage;
+    [MessageRole.Interrupt]: InterruptMessage;
     [MessageRole.Loading]: LoadingMessage;
     [MessageRole.Pause]: PauseMessage;
     [MessageRole.Placeholder]: PlaceholderMessage;

package/dist/ag-ui/types/schema.d.ts

@@ -0,0 +1,42 @@
+import type { FromSchema } from 'json-schema-to-ts';
+export declare const UserSingleChoiceQuestionSchema: {
+    readonly properties: {
+        readonly question: {
+            readonly enum: readonly [];
+            readonly type: "string";
+        };
+    };
+    readonly required: readonly ["question"];
+    readonly type: "object";
+};
+export declare const UserMultiChoiceQuestionSchema: {
+    readonly properties: {
+        readonly question: {
+            readonly items: {
+                readonly enum: readonly [];
+                readonly type: "string";
+            };
+            readonly uniqueItems: true;
+            readonly type: "array";
+        };
+    };
+    readonly required: readonly ["question"];
+    readonly type: "object";
+};
+export declare const UserQuestionSchema: {
+    readonly properties: {
+        readonly question: {
+            readonly items: {
+                readonly enum: readonly [];
+                readonly type: "string";
+            };
+            readonly uniqueItems: true;
+            readonly type: "array";
+        };
+    };
+    readonly required: readonly ["question"];
+    readonly type: "object";
+};
+export type UserMultiChoiceQuestion = FromSchema<typeof UserMultiChoiceQuestionSchema>;
+export type UserQuestion = UserMultiChoiceQuestion;
+export type UserSingleChoiceQuestion = FromSchema<typeof UserSingleChoiceQuestionSchema>;

package/dist/components/ai-questions/questions-container.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/ai-questions/selection-question.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-content/flow-agent-content/flow-agent-content.vue.d.ts

@@ -1,9 +1,12 @@
 import type { MessageStatus as MessageStatusType } from '../../../ag-ui/types/constants';
 import type { BkFlowMessageContent } from '../../../ag-ui/types/contents';
+import type { OnInterruptResume } from '../../../ag-ui/types/interrupt';
 import 'tippy.js/dist/tippy.css';
 type __VLS_Props = {
     content?: BkFlowMessageContent;
     messageUid?: string;
+    /** resume 回调：节点「重试 / 跳过」与第三方审批取消复用同一回调，按 payload.operation 分流 */
+    onInterruptResume?: OnInterruptResume;
     status?: MessageStatusType;
 };
 type __VLS_ModelProps = {

package/dist/components/chat-content/flow-agent-content/use-flow-agent.d.ts

@@ -9,6 +9,10 @@ export interface FlowNodeVM {
     id: string;
     name: string;
     raw: BkFlowNode;
+    /** 是否可重试（失败节点行尾「重试」按钮的显隐依据） */
+    retryable: boolean;
+    /** 是否可跳过（失败节点行尾「跳过」按钮的显隐依据） */
+    skippable: boolean;
 }
 /** 统计概览项视图模型 */
 export interface FlowStatVM {

package/dist/components/chat-content/flow-agent-content/use-flow-node-actions.d.ts

@@ -0,0 +1,32 @@
+import type { Component, Ref } from 'vue';
+import { InterruptResumeOperation } from '../../../ag-ui/types/interrupt';
+import type { BkFlowNode, BkFlowTask } from '../../../ag-ui/types/contents';
+import type { OnInterruptResume } from '../../../ag-ui/types/interrupt';
+import type { FlowNodeVM, FlowTaskVM } from './use-flow-agent';
+/** 节点行尾操作类型标识 */
+export type FlowNodeActionId = 'detail' | InterruptResumeOperation.FlowNodeRetry | InterruptResumeOperation.FlowNodeSkip;
+/** 节点行尾操作视图模型：详情 / 重试 / 跳过统一为同一渲染单元（图标 + 文案 + 点击） */
+export interface FlowNodeActionVM {
+    /** 按钮图标组件 */
+    icon: Component;
+    /** 唯一标识，用于 v-for key 与样式钩子 */
+    id: FlowNodeActionId;
+    /** 国际化文案 */
+    label: string;
+    /** 点击执行 */
+    run: () => void;
+}
+/**
+ * flow-agent 节点行尾操作 composable。
+ *
+ * 将「详情（打开侧栏）」与「重试 / 跳过（回传 Agent resume）」聚合为统一的、声明式的
+ * 操作列表，组件层只需遍历渲染，显隐与点击行为均收敛于此，便于复用、单测与扩展。
+ */
+export declare const useFlowNodeActions: (options: {
+    /** resume 回调（与第三方审批取消同一回调，按 payload.operation 分流） */
+    onInterruptResume: Ref<OnInterruptResume | undefined>;
+    /** 打开节点详情侧栏（复用 useFlowTab 的能力） */
+    openNodeDetail: (task: BkFlowTask, node: BkFlowNode) => void;
+}) => {
+    getNodeActions: (task: FlowTaskVM, node: FlowNodeVM) => FlowNodeActionVM[];
+};

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

@@ -0,0 +1,2 @@
+export { default as MarkdownContent } from './markdown-content/markdown-content.vue';
+export { default as VNodeRenderer } from './vnode-renderer';

package/dist/components/chat-input/ai-slash-input/command.d.ts

@@ -1,7 +1,6 @@
 import type { EditorCommand } from '../../../edix';
 import type { Position } from '../../../edix/doc/types';
-import type { IAiSlashMenuItem, ISkillListItem } from '../../../types/editor';
+import type { IAiSlashMenuItem } from '../../../types/editor';
 export declare const DeleteTag: EditorCommand<[Position, Position]>;
 export declare const InsertTag: EditorCommand<[Position, IAiSlashMenuItem]>;
 export declare const InsertText: EditorCommand<[Position, string]>;
-export declare const InsertSkillTag: EditorCommand<[Position, ISkillListItem]>;

package/dist/components/chat-input/ai-slash-input/constants.d.ts

@@ -1,7 +1,3 @@
-import type { VoidNode } from '../../../edix/doc/types';
-import type { TagSchema } from '../../../types/input';
-export declare const tagNodeToMessageString: (node: VoidNode) => string;
-export declare const tagSchemaToMessageString: (doc: TagSchema) => string;
 export declare const tagSchema: import("../../..").DocSchema<({
     text: string;
     type: "text";

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

@@ -1,4 +1,4 @@
-import { type UserMessage, MessageContentType, MessageStatus } from '../../ag-ui/types';
+import { type Interrupt, type InterruptResume, type UserMessage, MessageContentType, MessageStatus } from '../../ag-ui/types';
 import { type AITippyProps, type IAiSlashMenuItem, type ISkillListItem, type Shortcut, type TagSchema, type UploadFile, UploadStatus } from '../../types';
 export type ChatInputEmits = {
     (e: 'selectShortcut', shortcut: Shortcut): void;
@@ -10,7 +10,10 @@ export type ChatInputProps = {
     inputMaxHeight?: number;
     messageStatus?: MessageStatus;
     modelValue: string | TagSchema;
-    onSendMessage?: (message: UserMessage['content'], docSchema: TagSchema) => Promise<void>;
+    onSendMessage?: (message: UserMessage['content'], docSchema: TagSchema, options?: {
+        interrupt?: Interrupt;
+        payload?: InterruptResume;
+    }) => Promise<void>;
     onStopSending?: () => Promise<void>;
     onUpload?: (files: File) => Promise<{
         download_url?: string;
@@ -18,6 +21,7 @@ export type ChatInputProps = {
     placeholder?: string;
     prompts?: string[];
     resources?: IAiSlashMenuItem[];
+    sendDisabledTip?: string;
     shortcutId?: string;
     shortcuts?: Shortcut[];
     skills?: ISkillListItem[];
@@ -29,7 +33,7 @@ type __VLS_ModelProps = {
     'cite'?: string;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_12: {
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_14: {
     files: {
         data?: string | undefined;
         filename?: string | undefined;
@@ -51,17 +55,19 @@ declare var __VLS_1: {}, __VLS_3: {}, __VLS_12: {
         } | undefined;
         status?: UploadStatus | undefined;
     }[];
-}, __VLS_49: {}, __VLS_73: {};
+}, __VLS_51: {}, __VLS_75: {};
 type __VLS_Slots = {} & {
     top?: (props: typeof __VLS_1) => any;
 } & {
-    'input-header'?: (props: typeof __VLS_3) => any;
+    interrupt?: (props: typeof __VLS_3) => any;
 } & {
-    files?: (props: typeof __VLS_12) => any;
+    'input-header'?: (props: typeof __VLS_5) => any;
 } & {
-    attachment?: (props: typeof __VLS_49) => any;
+    files?: (props: typeof __VLS_14) => any;
 } & {
-    'send-icon'?: (props: typeof __VLS_73) => any;
+    attachment?: (props: typeof __VLS_51) => any;
+} & {
+    'send-icon'?: (props: typeof __VLS_75) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void;

package/dist/components/chat-input/input-attachment/input-attachment.vue.d.ts

@@ -3,6 +3,7 @@ import type { AITippyProps } from '../../../types';
 import 'tippy.js/dist/tippy.css';
 type __VLS_Props = {
     messageState?: MessageStatus;
+    sendDisabledTip?: string;
     tippyOptions?: AITippyProps;
 };
 declare var __VLS_1: {}, __VLS_3: {};

package/dist/components/chat-input/input-info-alert.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    content: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/activity-message/activity-message.vue.d.ts

@@ -1,5 +1,8 @@
+import type { OnInterruptResume } from '../../../ag-ui/types/interrupt';
 import type { ActivityMessage } from '../../../ag-ui/types/messages';
-type __VLS_Props = Partial<ActivityMessage>;
+type __VLS_Props = Partial<ActivityMessage> & {
+    onInterruptResume?: OnInterruptResume;
+};
 type __VLS_ModelProps = {
     'collapsed'?: boolean;
 };

package/dist/components/chat-message/assistant-message/assistant-message.vue.d.ts

@@ -1,6 +1,6 @@
 import type { AssistantMessage } from '../../../ag-ui/types/messages';
 declare var __VLS_1: {
-    content: string;
+    content: string | undefined;
 };
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;

package/dist/components/chat-message/interrupt-message/index.d.ts

@@ -0,0 +1,2 @@
+export { default as InterruptMessageRender } from './interrupt-message.vue';
+export * from './user-question';

package/dist/components/chat-message/interrupt-message/interrupt-message.vue.d.ts

@@ -0,0 +1,17 @@
+import type { InterruptMessage, OnInterruptResume } from '../../../ag-ui/types/interrupt';
+import type { UserQuestionAnsweredCardSlots } from './user-question/user-question-answered-card.vue';
+type __VLS_Slots = {
+    answeredQuestion: UserQuestionAnsweredCardSlots['answer'];
+};
+type __VLS_Props = Partial<InterruptMessage> & {
+    onInterruptResume?: OnInterruptResume;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/chat-message/interrupt-message/tool-approval-card.vue.d.ts

@@ -0,0 +1,9 @@
+import type { AIDevToolApprovalInterrupt, OnInterruptResume } from '../../../ag-ui/types/interrupt';
+type __VLS_Props = {
+    interrupt: AIDevToolApprovalInterrupt;
+    onInterruptResume?: OnInterruptResume;
+    readonly?: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/interrupt-message/user-question/index.d.ts

@@ -0,0 +1,5 @@
+export * from './use-user-question';
+export { default as UserQuestionAnsweredCard } from './user-question-answered-card.vue';
+export { default as UserQuestionCard } from './user-question-card.vue';
+export { default as UserQuestionChoice } from './user-question-choice.vue';
+export { default as UserQuestionOption } from './user-question-option.vue';

package/dist/components/chat-message/interrupt-message/user-question/use-user-question.d.ts

@@ -0,0 +1,35 @@
+import type { UserQuestionAnswerItem, UserQuestionInterrupt, UserQuestionItem, UserQuestionOptionItem, UserQuestionResume } from '../../../../ag-ui/types/interrupt';
+/** label 为该值的选项代表「Others 自定义输入」 */
+export declare const OTHERS_OPTION_LABEL = "others";
+/** 选项序号字母：0 -> A、1 -> B …… 超过 26 时回退为数字 */
+export declare const toLetter: (index: number) => string;
+/** 归一化后的展示选项（含字母序号与 Others 标记），由选择题渲染组件内部使用 */
+export type NormalizedUserQuestionOption = UserQuestionOptionItem & {
+    isOthers: boolean;
+    letter: string;
+};
+/**
+ * 用户回答问题（human-in-the-loop）的答案聚合与 resume payload 构建。
+ *
+ * 设计目标：composable 只负责「收集每题答案 + 完成态计算 + payload 组装」，
+ * 对「回答形态」（单选/多选/表单/任意自定义）零感知；
+ * 各题如何作答与如何校验，全部下沉到对应的渲染组件（默认为选择题），
+ * 渲染组件作答有效时回传已组装的 {@link UserQuestionAnswerItem}，无效时回传 undefined。
+ *
+ * @param getInterrupt 返回当前 UserQuestion 中断的 getter（响应式）
+ */
+export declare const useUserQuestion: (getInterrupt: () => undefined | UserQuestionInterrupt) => {
+    questions: import("vue").ComputedRef<UserQuestionItem[]>;
+    answeredCount: import("vue").ComputedRef<number>;
+    totalCount: import("vue").ComputedRef<number>;
+    completed: import("vue").ComputedRef<boolean>;
+    getAnswer: (questionIndex: number) => undefined | UserQuestionAnswerItem;
+    setAnswer: (questionIndex: number, answer: undefined | UserQuestionAnswerItem) => void;
+    buildResolvePayload: () => UserQuestionResume;
+    buildSkipPayload: () => UserQuestionResume;
+};
+/**
+ * 自由文本 resume（用户在 chat-input 直接输入而非走结构化选择）。
+ * 多题场景下信息有损：统一作为单条 Others 自由文本回传。
+ */
+export declare const buildSkipResumePayload: (interrupt?: UserQuestionInterrupt) => UserQuestionResume;

package/dist/components/chat-message/interrupt-message/user-question/user-question-answered-card.vue.d.ts

@@ -0,0 +1,25 @@
+import { type VNode } from 'vue';
+import type { UserQuestionAnswerItem } from '../../../../ag-ui/types/interrupt';
+type __VLS_Props = {
+    answers: UserQuestionAnswerItem[];
+    status?: 'cancelled' | 'resolved';
+};
+export type UserQuestionAnsweredCardSlots = {
+    answer: (props: {
+        index: number;
+        item: UserQuestionAnswerItem;
+        status: 'cancelled' | 'resolved';
+    }) => null | undefined | VNode;
+};
+type __VLS_Slots = UserQuestionAnsweredCardSlots;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    status: "cancelled" | "resolved";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/chat-message/interrupt-message/user-question/user-question-card.vue.d.ts

@@ -0,0 +1,25 @@
+import { type VNode } from 'vue';
+import type { OnInterruptResume, UserQuestionAnswerItem, UserQuestionInterrupt, UserQuestionItem } from '../../../../ag-ui/types/interrupt';
+type __VLS_Props = {
+    interrupt: UserQuestionInterrupt;
+    onResume?: OnInterruptResume;
+};
+export type UserQuestionCardSlots = {
+    question: (props: {
+        answer: undefined | UserQuestionAnswerItem;
+        confirm: () => void;
+        qIndex: number;
+        question: UserQuestionItem;
+        setAnswer: (answer: undefined | UserQuestionAnswerItem) => void;
+    }) => null | undefined | VNode;
+};
+type __VLS_Slots = UserQuestionCardSlots;
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/chat-message/interrupt-message/user-question/user-question-choice.vue.d.ts

@@ -0,0 +1,13 @@
+import type { UserQuestionAnswerItem, UserQuestionItem } from '../../../../ag-ui/types/interrupt';
+type __VLS_Props = {
+    question: UserQuestionItem;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    answer: (answer: UserQuestionAnswerItem | undefined) => any;
+    confirm: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAnswer?: ((answer: UserQuestionAnswerItem | undefined) => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/interrupt-message/user-question/user-question-option.vue.d.ts

@@ -0,0 +1,17 @@
+import type { NormalizedUserQuestionOption } from './use-user-question';
+type __VLS_Props = {
+    option: NormalizedUserQuestionOption;
+    othersText?: string;
+    selected: boolean;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: () => any;
+    confirm: () => any;
+    "update:othersText": (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: (() => any) | undefined;
+    onConfirm?: (() => any) | undefined;
+    "onUpdate:othersText"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;