@xinghunm/ai-chat 1.0.1 → 1.0.2

package/dist/index.d.mts

@@ -102,11 +102,28 @@ interface PlanBooleanQuestion extends PlanQuestionBase {
  */
 type PlanQuestion = PlanSingleSelectQuestion | PlanMultiSelectQuestion | PlanTextQuestion | PlanNumberQuestion | PlanBooleanQuestion;
 type PlanQuestionnaireStatus = 'expired' | 'failed';
+/**
+ * Merge behavior applied when a keyed structured block is patched repeatedly.
+ */
+type ChatBlockMergePolicy = 'append' | 'replace' | 'ignore-duplicate';
 /**
  * Structured question form emitted for plan-mode clarification flows.
  */
 interface PlanQuestionnaire {
     questionnaireId: string;
+    /**
+     * Stable key used to identify the same logical questionnaire across streaming patches.
+     * When present, questionnaires are merged by `blockKey` instead of `questionnaireId`.
+     */
+    blockKey?: string;
+    /**
+     * Merge strategy used when another questionnaire with the same key arrives.
+     *
+     * - `append`: keep appending questionnaires even if the key matches.
+     * - `replace`: replace the existing keyed questionnaire with the latest one.
+     * - `ignore-duplicate`: keep the first keyed questionnaire and ignore later duplicates.
+     */
+    mergePolicy?: ChatBlockMergePolicy;
     title?: string;
     description?: string;
     submitLabel?: string;
@@ -120,6 +137,10 @@ interface PlanQuestionnaire {
  */
 interface PlanQuestionnaireSubmission {
     questionnaireId: string;
+    /**
+     * Stable questionnaire block key forwarded from the rendered card when available.
+     */
+    blockKey?: string;
     answers: Record<string, PlanQuestionnaireAnswerValue>;
     content: string;
     sourceMessageId?: string;
@@ -168,10 +189,6 @@ interface ResultSummary {
     headline: string;
     details: string[];
 }
-/**
- * Merge behavior applied when a keyed custom block is patched repeatedly.
- */
-type ChatCustomBlockMergePolicy = 'append' | 'replace' | 'ignore-duplicate';
 /**
  * Extensible custom block rendered by a consumer-provided block renderer.
  */
@@ -191,7 +208,7 @@ interface ChatCustomBlock {
      * - `replace`: replace the existing keyed block with the latest one.
      * - `ignore-duplicate`: keep the first keyed block and ignore later duplicates.
      */
-    mergePolicy?: ChatCustomBlockMergePolicy;
+    mergePolicy?: ChatBlockMergePolicy;
 }
 /**
  * Structured assistant block variants rendered by the chat thread.

package/dist/index.d.ts

@@ -102,11 +102,28 @@ interface PlanBooleanQuestion extends PlanQuestionBase {
  */
 type PlanQuestion = PlanSingleSelectQuestion | PlanMultiSelectQuestion | PlanTextQuestion | PlanNumberQuestion | PlanBooleanQuestion;
 type PlanQuestionnaireStatus = 'expired' | 'failed';
+/**
+ * Merge behavior applied when a keyed structured block is patched repeatedly.
+ */
+type ChatBlockMergePolicy = 'append' | 'replace' | 'ignore-duplicate';
 /**
  * Structured question form emitted for plan-mode clarification flows.
  */
 interface PlanQuestionnaire {
     questionnaireId: string;
+    /**
+     * Stable key used to identify the same logical questionnaire across streaming patches.
+     * When present, questionnaires are merged by `blockKey` instead of `questionnaireId`.
+     */
+    blockKey?: string;
+    /**
+     * Merge strategy used when another questionnaire with the same key arrives.
+     *
+     * - `append`: keep appending questionnaires even if the key matches.
+     * - `replace`: replace the existing keyed questionnaire with the latest one.
+     * - `ignore-duplicate`: keep the first keyed questionnaire and ignore later duplicates.
+     */
+    mergePolicy?: ChatBlockMergePolicy;
     title?: string;
     description?: string;
     submitLabel?: string;
@@ -120,6 +137,10 @@ interface PlanQuestionnaire {
  */
 interface PlanQuestionnaireSubmission {
     questionnaireId: string;
+    /**
+     * Stable questionnaire block key forwarded from the rendered card when available.
+     */
+    blockKey?: string;
     answers: Record<string, PlanQuestionnaireAnswerValue>;
     content: string;
     sourceMessageId?: string;
@@ -168,10 +189,6 @@ interface ResultSummary {
     headline: string;
     details: string[];
 }
-/**
- * Merge behavior applied when a keyed custom block is patched repeatedly.
- */
-type ChatCustomBlockMergePolicy = 'append' | 'replace' | 'ignore-duplicate';
 /**
  * Extensible custom block rendered by a consumer-provided block renderer.
  */
@@ -191,7 +208,7 @@ interface ChatCustomBlock {
      * - `replace`: replace the existing keyed block with the latest one.
      * - `ignore-duplicate`: keep the first keyed block and ignore later duplicates.
      */
-    mergePolicy?: ChatCustomBlockMergePolicy;
+    mergePolicy?: ChatBlockMergePolicy;
 }
 /**
  * Structured assistant block variants rendered by the chat thread.

package/dist/index.js

@@ -124,6 +124,22 @@ var mergeStreamingBlocks = (existingBlocks, incomingBlocks) => {
       nextBlocks.push(incomingBlock);
       return;
     }
+    if (incomingBlock.type === "questionnaire" && incomingBlock.questionnaire.blockKey) {
+      const mergePolicy = incomingBlock.questionnaire.mergePolicy ?? "append";
+      if (mergePolicy !== "append") {
+        const existingIndex2 = nextBlocks.findIndex(
+          (block) => block.type === "questionnaire" && block.questionnaire.blockKey === incomingBlock.questionnaire.blockKey
+        );
+        if (existingIndex2 !== -1) {
+          if (mergePolicy === "replace") {
+            nextBlocks[existingIndex2] = incomingBlock;
+          }
+          return;
+        }
+      }
+      nextBlocks.push(incomingBlock);
+      return;
+    }
     if (incomingBlock.type !== "questionnaire") {
       nextBlocks.push(incomingBlock);
       return;
@@ -1024,7 +1040,7 @@ var getTimelineBlockKey = (block, index) => {
     case "result_summary":
       return `${index}:result_summary:${block.summary.summaryId}:${block.summary.status}`;
     case "questionnaire":
-      return `${index}:questionnaire:${block.questionnaire.questionnaireId}`;
+      return block.questionnaire.blockKey ? `questionnaire:${block.questionnaire.blockKey}` : `${index}:questionnaire:${block.questionnaire.questionnaireId}`;
     case "custom":
       return block.blockKey ? `custom:${block.blockKey}` : `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
     default:
@@ -1672,6 +1688,7 @@ var QuestionnaireCardInner = ({
     try {
       await onSubmit?.({
         questionnaireId: questionnaire.questionnaireId,
+        ...questionnaire.blockKey ? { blockKey: questionnaire.blockKey } : {},
         answers: normalizedAnswers,
         content: contentLines.join("\n")
       });
@@ -2483,7 +2500,7 @@ var ChatMessageItemView = ({
               sourceMessageId: message.id
             }) : void 0
           }
-        ) }, `questionnaire-${index}`);
+        ) }, block.questionnaire.blockKey ?? `questionnaire-${index}`);
       case "custom":
         return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_react9.Fragment, { children: renderMessageBlock?.({
           block,

package/dist/index.mjs

@@ -77,6 +77,22 @@ var mergeStreamingBlocks = (existingBlocks, incomingBlocks) => {
       nextBlocks.push(incomingBlock);
       return;
     }
+    if (incomingBlock.type === "questionnaire" && incomingBlock.questionnaire.blockKey) {
+      const mergePolicy = incomingBlock.questionnaire.mergePolicy ?? "append";
+      if (mergePolicy !== "append") {
+        const existingIndex2 = nextBlocks.findIndex(
+          (block) => block.type === "questionnaire" && block.questionnaire.blockKey === incomingBlock.questionnaire.blockKey
+        );
+        if (existingIndex2 !== -1) {
+          if (mergePolicy === "replace") {
+            nextBlocks[existingIndex2] = incomingBlock;
+          }
+          return;
+        }
+      }
+      nextBlocks.push(incomingBlock);
+      return;
+    }
     if (incomingBlock.type !== "questionnaire") {
       nextBlocks.push(incomingBlock);
       return;
@@ -977,7 +993,7 @@ var getTimelineBlockKey = (block, index) => {
     case "result_summary":
       return `${index}:result_summary:${block.summary.summaryId}:${block.summary.status}`;
     case "questionnaire":
-      return `${index}:questionnaire:${block.questionnaire.questionnaireId}`;
+      return block.questionnaire.blockKey ? `questionnaire:${block.questionnaire.blockKey}` : `${index}:questionnaire:${block.questionnaire.questionnaireId}`;
     case "custom":
       return block.blockKey ? `custom:${block.blockKey}` : `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
     default:
@@ -1625,6 +1641,7 @@ var QuestionnaireCardInner = ({
     try {
       await onSubmit?.({
         questionnaireId: questionnaire.questionnaireId,
+        ...questionnaire.blockKey ? { blockKey: questionnaire.blockKey } : {},
         answers: normalizedAnswers,
         content: contentLines.join("\n")
       });
@@ -2436,7 +2453,7 @@ var ChatMessageItemView = ({
               sourceMessageId: message.id
             }) : void 0
           }
-        ) }, `questionnaire-${index}`);
+        ) }, block.questionnaire.blockKey ?? `questionnaire-${index}`);
       case "custom":
         return /* @__PURE__ */ jsx8(Fragment, { children: renderMessageBlock?.({
           block,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xinghunm/ai-chat",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "AI chat React component library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",