@xinghunm/ai-chat 1.0.0 → 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,6 +189,27 @@ interface ResultSummary {
     headline: string;
     details: string[];
 }
+/**
+ * Extensible custom block rendered by a consumer-provided block renderer.
+ */
+interface ChatCustomBlock {
+    type: 'custom';
+    kind: string;
+    data: unknown;
+    /**
+     * Stable key used to identify the same logical block across streaming patches.
+     * When present, keyed custom blocks are merged by `blockKey` regardless of `kind`.
+     */
+    blockKey?: string;
+    /**
+     * Merge strategy used when another custom block with the same key arrives.
+     *
+     * - `append`: keep appending blocks even if the key matches.
+     * - `replace`: replace the existing keyed block with the latest one.
+     * - `ignore-duplicate`: keep the first keyed block and ignore later duplicates.
+     */
+    mergePolicy?: ChatBlockMergePolicy;
+}
 /**
  * Structured assistant block variants rendered by the chat thread.
  */
@@ -190,11 +232,7 @@ type ChatMessageBlock = {
 } | {
     type: 'questionnaire';
     questionnaire: PlanQuestionnaire;
-} | {
-    type: 'custom';
-    kind: string;
-    data: unknown;
-};
+} | ChatCustomBlock;
 /**
  * Supported message body render orders for mixed text and structured blocks.
  */

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,6 +189,27 @@ interface ResultSummary {
     headline: string;
     details: string[];
 }
+/**
+ * Extensible custom block rendered by a consumer-provided block renderer.
+ */
+interface ChatCustomBlock {
+    type: 'custom';
+    kind: string;
+    data: unknown;
+    /**
+     * Stable key used to identify the same logical block across streaming patches.
+     * When present, keyed custom blocks are merged by `blockKey` regardless of `kind`.
+     */
+    blockKey?: string;
+    /**
+     * Merge strategy used when another custom block with the same key arrives.
+     *
+     * - `append`: keep appending blocks even if the key matches.
+     * - `replace`: replace the existing keyed block with the latest one.
+     * - `ignore-duplicate`: keep the first keyed block and ignore later duplicates.
+     */
+    mergePolicy?: ChatBlockMergePolicy;
+}
 /**
  * Structured assistant block variants rendered by the chat thread.
  */
@@ -190,11 +232,7 @@ type ChatMessageBlock = {
 } | {
     type: 'questionnaire';
     questionnaire: PlanQuestionnaire;
-} | {
-    type: 'custom';
-    kind: string;
-    data: unknown;
-};
+} | ChatCustomBlock;
 /**
  * Supported message body render orders for mixed text and structured blocks.
  */

package/dist/index.js

@@ -108,6 +108,38 @@ var resolveSessionTitleFromMessage = (message) => {
 var mergeStreamingBlocks = (existingBlocks, incomingBlocks) => {
   const nextBlocks = [...existingBlocks ?? []];
   incomingBlocks.forEach((incomingBlock) => {
+    if (incomingBlock.type === "custom" && incomingBlock.blockKey) {
+      const mergePolicy = incomingBlock.mergePolicy ?? "append";
+      if (mergePolicy !== "append") {
+        const existingIndex2 = nextBlocks.findIndex(
+          (block) => block.type === "custom" && block.blockKey === incomingBlock.blockKey
+        );
+        if (existingIndex2 !== -1) {
+          if (mergePolicy === "replace") {
+            nextBlocks[existingIndex2] = incomingBlock;
+          }
+          return;
+        }
+      }
+      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;
@@ -1008,9 +1040,9 @@ 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 `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
+      return block.blockKey ? `custom:${block.blockKey}` : `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
     default:
       return null;
   }
@@ -1656,6 +1688,7 @@ var QuestionnaireCardInner = ({
     try {
       await onSubmit?.({
         questionnaireId: questionnaire.questionnaireId,
+        ...questionnaire.blockKey ? { blockKey: questionnaire.blockKey } : {},
         answers: normalizedAnswers,
         content: contentLines.join("\n")
       });
@@ -2467,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

@@ -61,6 +61,38 @@ var resolveSessionTitleFromMessage = (message) => {
 var mergeStreamingBlocks = (existingBlocks, incomingBlocks) => {
   const nextBlocks = [...existingBlocks ?? []];
   incomingBlocks.forEach((incomingBlock) => {
+    if (incomingBlock.type === "custom" && incomingBlock.blockKey) {
+      const mergePolicy = incomingBlock.mergePolicy ?? "append";
+      if (mergePolicy !== "append") {
+        const existingIndex2 = nextBlocks.findIndex(
+          (block) => block.type === "custom" && block.blockKey === incomingBlock.blockKey
+        );
+        if (existingIndex2 !== -1) {
+          if (mergePolicy === "replace") {
+            nextBlocks[existingIndex2] = incomingBlock;
+          }
+          return;
+        }
+      }
+      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;
@@ -961,9 +993,9 @@ 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 `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
+      return block.blockKey ? `custom:${block.blockKey}` : `${index}:custom:${block.kind}:${stringifyTimelineKeyPart(block.data)}`;
     default:
       return null;
   }
@@ -1609,6 +1641,7 @@ var QuestionnaireCardInner = ({
     try {
       await onSubmit?.({
         questionnaireId: questionnaire.questionnaireId,
+        ...questionnaire.blockKey ? { blockKey: questionnaire.blockKey } : {},
         answers: normalizedAnswers,
         content: contentLines.join("\n")
       });
@@ -2420,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.0",
+  "version": "1.0.2",
   "description": "AI chat React component library",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",