@blade-hq/agent-react 2612.0.0-beta.47 → 2612.0.0-beta.49

package/README.md

@@ -493,3 +493,11 @@ ChatView 和 `<blade-chat>` 的默认轻量输入支持 @ 搜索插件条目，
 ### 应用资料展示
 
 共享聊天视图展示消息级 `context_attachments`：气泡只显示正文，资料标签可展开查看纯文本详情，`data` 中的内部 JSON 与 ID 不显示。`ChatSendOptions.contextAttachments` 可沿共享发送入口传入 SDK；可靠后台发送使用 `AgentSession.prepareSend` / `sendPrepared`。文件读取使用当前 `BladeProvider` 的 `BladeClient` 和资料指定的会话权限，失效或没有来源的文件显示「文件不可用」。内置 Web、扩展和嵌入视图使用相同实现。
+
+### 独立嵌入提问卡片（React 19+）
+
+自行管理消息时间线的宿主可从 `@blade-hq/agent-react/questions` 按需导入 `QuestionnaireQuestionBlock`（也导出为 `AskUserQuestionBlock`），无需加载整个 `ChatView`。该入口基于官方 shadcn Questionnaire，遵循 `@shadcn/react` 的 React 19+ 要求；原有 `ChatView` 入口及其问答渲染器保留 React 18 支持。
+
+入口同时导出 `AskUserQuestionData` 和 `AskUserAnswerData` 类型。通过 `data`、`answered`、`answerData` 和 `sessionStatus` 提供问题及状态；`onAnswer(text, toolCallId, answerData)` 交给宿主，使用 `session.send(text, { askUserAnswer: { tool_call_id: toolCallId, ...answerData } })` 将原生结构化回答送回原始会话，不能送入普通文本队列。
+
+Questionnaire 负责必答校验、原生单选/多选、自填和前后分页，不提供跳过问题的业务行为。宿主负责传输、提交失败反馈、刷新已保存的回答及主题样式；提交失败时以 `sessionStatus="failed"` 恢复当前选择供重试。问题类型及文本格式化函数与 BA 原生协议共用。

package/dist/chat/AskUserQuestionBlock.d.ts

@@ -1,22 +1,6 @@
-import type { AskUserAnswerData } from "@blade-hq/agent-client";
-export type { AskUserAnswerData };
-interface OptionItem {
-    label: string;
-    description: string;
-}
-interface QuestionItem {
-    question: string;
-    options: OptionItem[];
-    multiSelect?: boolean;
-}
-interface SourceLoopInfo {
-    loop_name: string;
-    description: string;
-}
-export interface AskUserQuestionData {
-    questions: QuestionItem[];
-    source_loop?: SourceLoopInfo | null;
-}
+import type { AskUserAnswerData, AskUserQuestionData } from "@blade-hq/agent-client";
+export { parseAskUserQuestion } from "@blade-hq/agent-client";
+export type { AskUserAnswerData, AskUserQuestionData };
 interface Props {
     data: AskUserQuestionData;
     answered: boolean;
@@ -26,7 +10,6 @@ interface Props {
     onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
 }
 export declare function AskUserQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer, }: Props): import("react/jsx-runtime").JSX.Element;
-export declare function parseAskUserQuestion(toolResult: string | null | undefined): AskUserQuestionData | null;
 export interface AskUserQuestionError {
     message: string;
     detail: string | null;

package/dist/chat/QuestionnaireQuestionBlock.d.ts

@@ -0,0 +1,11 @@
+import type { AskUserAnswerData, AskUserQuestionData } from "@blade-hq/agent-client";
+export type { AskUserAnswerData, AskUserQuestionData };
+interface Props {
+    data: AskUserQuestionData;
+    answered: boolean;
+    toolCallId: string;
+    sessionStatus: string;
+    answerData?: AskUserAnswerData | undefined;
+    onAnswer?: (answer: string, toolCallId: string, answerData: AskUserAnswerData) => void;
+}
+export declare function QuestionnaireQuestionBlock({ data, answered, toolCallId, sessionStatus, answerData, onAnswer }: Props): import("react/jsx-runtime").JSX.Element;

package/dist/chat/runtime/input-services.d.ts

@@ -66,8 +66,8 @@ export interface InputDataState<T> {
 export interface ConnectorComputerSectionProps {
     sessionId: string | null;
     query: string;
-    pendingSelection?: string[];
-    onPendingSelectionChange?: (ids: string[]) => void;
+    excludedSelection?: string[];
+    onExcludedSelectionChange?: (ids: string[]) => void;
     /** 收起连接器面板（打开设置之类的动作前调用）。 */
     closePanel: () => void;
 }