@aleph-alpha/chat-kit 1.11.1 → 1.13.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { useChat, useConversationSessions, useConversations, } from './composabl
 export type { ChatActions, ChatState, ConversationSession, CreateConversationInput, MessageHandler, MutationOptions, UseChatReturn, UseConversationSessionsReturn, UseConversationsOptions, UseConversationsReturn, } from './composables';
 export { SdkError, createDocumentUploadProvider, defaultDocumentUploadConfig, defaultEndpoints, useDocumentUploadWithDefaultConfig, } from './composables/fileUpload';
 export type { DocumentUploadConfig, DocumentUploadProvider, FileEntry, FileStatus, } from './composables/fileUpload';
-export { CkAgentMessage, CkConversation, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkFileItemsList, CkHistory, CkHistoryItem, CkHistoryWrapper, CkInput, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './components';
-export type { CkConversationLayoutProps, CkConversationProps, CkFeedbackButtonProps, CkFeedbackValue, CkFileEntry, CkFileItemsListEmits, CkFileItemsListProps, CkHistoryEmits, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './components';
-export type { BaseMessage, Conversation, ConversationTree, MessageContent, MessageContentStatus, MessageReasoningContent, MessageRole, MessageStatus, MessageTextContent, MessageToolContent, TreeMessage, } from './types';
+export { CkAgentMessage, CkConversation, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkFeedbackDialog, CkFileItemsList, CkHistory, CkHistoryItem, CkHistoryWrapper, CkInput, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './components';
+export type { CkConversationLayoutProps, CkConversationProps, CkFeedbackButtonProps, CkFeedbackDialogEmits, CkFeedbackDialogProps, CkFeedbackDialogSubmitPayload, CkFeedbackReason, CkFeedbackSentiment, CkFeedbackValue, CkFileEntry, CkFileItemsListEmits, CkFileItemsListProps, CkHistoryEmits, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './components';
+export type { BaseMessage, Conversation, ConversationTree, MessageContent, MessageContentStatus, MessageMetadata, MessageReasoningContent, MessageRole, MessageStatus, MessageTextContent, MessageToolContent, TreeMessage, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,UAAU,GACX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AASpB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,aAAa,EACb,6BAA6B,EAC7B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,4BAA4B,EAC5B,2BAA2B,EAC3B,gBAAgB,EAChB,kCAAkC,GACnC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,SAAS,EACT,UAAU,GACX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,UAAU,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,7 +1,7 @@
-import { u } from "./useMessageHandler-ZRC-gIOJ.js";
-import { C, d, p, u as u2, a } from "./useChatKitLabels-ftC52m7f.js";
-import { S, c, d as d2, a as a2, u as u3, b, e, f } from "./index-BLq6_Lt2.js";
-import { _, a as a3, b as b2, C as C2, c as c2, d as d3, e as e2, f as f2, g, h, i, j, k, l, m, n, o, p as p2, q } from "./CkInput.vue_vue_type_script_setup_true_lang-C1Jnn1fK.js";
+import { u } from "./useMessageHandler-CMdy-lm0.js";
+import { C, d, p, u as u2, a } from "./useChatKitLabels-DeHxZG2a.js";
+import { S, c, d as d2, a as a2, u as u3, b, e, f } from "./index-Ct5hD214.js";
+import { _, a as a3, b as b2, C as C2, c as c2, d as d3, e as e2, f as f2, g, h, i, j, k, l, m, n, o, p as p2, q, r } from "./CkInput.vue_vue_type_script_setup_true_lang-DCZTSiBj.js";
 export {
   C as CHAT_KIT_LABELS,
   _ as CkAgentMessage,
@@ -9,20 +9,21 @@ export {
   b2 as CkConversationLayout,
   C2 as CkCopyMessageActionButton,
   c2 as CkFeedbackButton,
-  d3 as CkFileItemsList,
-  e2 as CkHistory,
-  f2 as CkHistoryItem,
-  g as CkHistoryWrapper,
-  h as CkInput,
-  i as CkMarkdownRenderer,
-  j as CkMessageActionButton,
-  k as CkPromptActionButton,
-  l as CkPromptInput,
-  m as CkPromptInputDisclaimer,
-  n as CkPromptStopButton,
-  o as CkSendIcon,
-  p2 as CkStopIcon,
-  q as CkUserMessage,
+  d3 as CkFeedbackDialog,
+  e2 as CkFileItemsList,
+  f2 as CkHistory,
+  g as CkHistoryItem,
+  h as CkHistoryWrapper,
+  i as CkInput,
+  j as CkMarkdownRenderer,
+  k as CkMessageActionButton,
+  l as CkPromptActionButton,
+  m as CkPromptInput,
+  n as CkPromptInputDisclaimer,
+  o as CkPromptStopButton,
+  p2 as CkSendIcon,
+  q as CkStopIcon,
+  r as CkUserMessage,
   S as SdkError,
   c as createDocumentUploadProvider,
   d as defaultChatKitLabels,

package/dist/types.d.ts

@@ -57,6 +57,18 @@ export interface MessageReasoningContent {
  * Discriminated union of all content parts that can appear inside a message.
  */
 export type MessageContent = MessageTextContent | MessageToolContent | MessageReasoningContent;
+/**
+ * Open-ended metadata bag carried alongside a message. chat-kit is
+ * intentionally agnostic about its contents — adapter authors
+ * (`responsesToTree`, …) and message handlers preserve the value verbatim
+ * through the tree → linear path projection, but never inspect it.
+ *
+ * Consumers attach their own well-known keys (attachments, citations,
+ * ratings, …) and define their own typed projections at the read site
+ * rather than extending this base type. That keeps the handler API stable
+ * even as the shape of what gets stored on a message evolves.
+ */
+export type MessageMetadata = Record<string, unknown>;
 export interface BaseMessage {
     id: string;
     role: MessageRole;
@@ -65,6 +77,7 @@ export interface BaseMessage {
     status: MessageStatus;
     siblingIds?: string[];
     siblingIndex?: number;
+    metadata?: MessageMetadata;
 }
 export interface TreeMessage {
     id: string;
@@ -75,6 +88,7 @@ export interface TreeMessage {
     content: MessageContent[];
     status: MessageStatus;
     createdAt: Date;
+    metadata?: MessageMetadata;
 }
 export interface ConversationTree {
     nodes: Record<string, TreeMessage>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/{useChatKitLabels-ftC52m7f.js → useChatKitLabels-DeHxZG2a.js}

@@ -12708,6 +12708,15 @@ const defaultChatKitLabels = {
   feedbackThumbsUp: "Good response",
   feedbackThumbsDown: "Bad response",
   feedbackGroup: "Rate this response",
+  feedbackDialogTitlePositive: "Give positive feedback",
+  feedbackDialogTitleNegative: "Give negative feedback",
+  feedbackDialogResponseHeading: "Response",
+  feedbackDialogDescription: "Select a reason and optionally add a comment, then submit your feedback.",
+  feedbackDialogOtherLabel: "Other",
+  feedbackDialogOtherTooltip: "Add anything else you want to share about this response.",
+  feedbackDialogFreeTextPlaceholder: "Write down some additional details",
+  feedbackDialogCancelLabel: "Cancel",
+  feedbackDialogSubmitLabel: "Submit",
   historyItemUntitled: "Untitled conversation",
   historyItemActionAriaLabel: "Conversation options",
   historyItemEditAction: "Edit",

package/dist/{useMessageHandler-ZRC-gIOJ.js → useMessageHandler-CMdy-lm0.js}

@@ -16,7 +16,8 @@ function getLinearPath(tree) {
       role: node.role,
       content: node.content,
       createdAt: node.createdAt,
-      status: node.status
+      status: node.status,
+      ...node.metadata !== void 0 ? { metadata: node.metadata } : {}
     };
     if (node.parentId !== null) {
       const parent = nodes[node.parentId];
@@ -49,6 +50,7 @@ function updateNode(tree, id, updates) {
   if (updates.content !== void 0) node.content = updates.content;
   if (updates.status !== void 0) node.status = updates.status;
   if (updates.role !== void 0) node.role = updates.role;
+  if ("metadata" in updates) node.metadata = updates.metadata;
 }
 function updateNodeId(tree, oldId, newId) {
   const node = tree.nodes[oldId];
@@ -69,6 +71,20 @@ function updateNodeId(tree, oldId, newId) {
   }
   if (tree.rootId === oldId) tree.rootId = newId;
 }
+function cutBranchAfter(tree, id) {
+  const node = tree.nodes[id];
+  if (!node) return;
+  const stack = [...node.childrenIds];
+  while (stack.length > 0) {
+    const currentId = stack.pop();
+    const current = tree.nodes[currentId];
+    if (!current) continue;
+    stack.push(...current.childrenIds);
+    delete tree.nodes[currentId];
+  }
+  node.childrenIds = [];
+  node.activeChildIndex = 0;
+}
 function navigate(tree, targetId) {
   const node = tree.nodes[targetId];
   if (!node || node.parentId === null) return;
@@ -92,7 +108,7 @@ const useMessageHandler = () => {
   function clearCurrentUserMessage() {
     currentUserMessage.value = "";
   }
-  function commitUserMessage() {
+  function commitUserMessage(opts) {
     const id = generateId();
     const text = currentUserMessage.value.trim();
     if (!text) throw new Error("No message");
@@ -107,17 +123,20 @@ const useMessageHandler = () => {
       role: "user",
       content,
       status: "completed",
-      createdAt: /* @__PURE__ */ new Date()
+      createdAt: /* @__PURE__ */ new Date(),
+      ...opts?.metadata !== void 0 ? { metadata: opts.metadata } : {}
     };
     addNode(tree, node);
     clearCurrentUserMessage();
-    return {
+    const base = {
       id: node.id,
       role: node.role,
       content: node.content,
       createdAt: node.createdAt,
       status: node.status
     };
+    if (node.metadata !== void 0) base.metadata = node.metadata;
+    return base;
   }
   function updateMessage(message) {
     const existing = tree.nodes[message.id];
@@ -125,7 +144,8 @@ const useMessageHandler = () => {
       updateNode(tree, message.id, {
         content: message.content,
         role: message.role,
-        status: message.status
+        status: message.status,
+        ...message.metadata !== void 0 ? { metadata: message.metadata } : {}
       });
     } else {
       const node = {
@@ -136,7 +156,8 @@ const useMessageHandler = () => {
         role: message.role,
         content: message.content,
         status: message.status,
-        createdAt: /* @__PURE__ */ new Date()
+        createdAt: /* @__PURE__ */ new Date(),
+        ...message.metadata !== void 0 ? { metadata: message.metadata } : {}
       };
       addNode(tree, node);
     }
@@ -144,13 +165,15 @@ const useMessageHandler = () => {
   function getMessageById(id) {
     const node = tree.nodes[id];
     if (!node) return void 0;
-    return {
+    const base = {
       id: node.id,
       role: node.role,
       content: node.content,
       createdAt: node.createdAt,
-      status: node.status
+      status: node.status,
+      ...node.metadata !== void 0 ? { metadata: node.metadata } : {}
     };
+    return base;
   }
   function updateMessageId(oldId, newId) {
     updateNodeId(tree, oldId, newId);
@@ -165,6 +188,9 @@ const useMessageHandler = () => {
   function navigate$1(targetId) {
     navigate(tree, targetId);
   }
+  function cutBranchAfter$1(messageId) {
+    cutBranchAfter(tree, messageId);
+  }
   return {
     messages,
     currentUserMessage: readonly(currentUserMessage),
@@ -177,7 +203,8 @@ const useMessageHandler = () => {
     updateMessageId,
     clearMessages,
     setTree,
-    navigate: navigate$1
+    navigate: navigate$1,
+    cutBranchAfter: cutBranchAfter$1
   };
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/chat-kit",
-  "version": "1.11.1",
+  "version": "1.13.0",
   "description": "Chat kit package for building chat interfaces with Vue",
   "type": "module",
   "main": "./dist/index.js",
@@ -65,15 +65,16 @@
     "vue": "^3.5.27"
   },
   "dependencies": {
+    "@aleph-alpha/ui-library": "^2.7.0",
     "dompurify": "^3.3.2",
     "rehype-stringify": "^10.0.1",
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
-    "unified": "^11.0.5",
-    "@aleph-alpha/ui-library": "2.6.2"
+    "unified": "^11.0.5"
   },
   "devDependencies": {
+    "@aleph-alpha/config-css": "^1.2.0",
     "@storybook/addon-a11y": "10.2.17",
     "@storybook/addon-docs": "10.2.17",
     "@storybook/addon-themes": "10.2.17",
@@ -96,8 +97,7 @@
     "vite": "^7.3.2",
     "vitest": "4.0.15",
     "vue": "^3.5.27",
-    "vue-tsc": "^3.2.4",
-    "@aleph-alpha/config-css": "1.2.0"
+    "vue-tsc": "^3.2.4"
   },
   "scripts": {
     "build": "vite build && vue-tsc --project tsconfig.build.json --declaration --emitDeclarationOnly --outDir dist",

package/src/adapters/responses-api.spec.ts

@@ -371,6 +371,76 @@ describe('responsesToTree', () => {
     }
   });
 
+  it('stamps the originating responseId onto every emitted node', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [assistantOutput('msg-a1', 'Hi')],
+      }),
+      makeResponse({
+        id: 'r2',
+        previous_response_id: 'r1',
+        request_input: [userInput('Follow-up')],
+        output: [assistantOutput('msg-a2', 'Reply')],
+      }),
+    ]);
+
+    expect(tree.nodes['user-r1-0']!.metadata.responseId).toBe('r1');
+    expect(tree.nodes['msg-a1']!.metadata.responseId).toBe('r1');
+    expect(tree.nodes['user-r2-0']!.metadata.responseId).toBe('r2');
+    expect(tree.nodes['msg-a2']!.metadata.responseId).toBe('r2');
+  });
+
+  it('parses metadata.attachments (JSON-encoded string) onto the first user node of a response', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('With files')],
+        output: [assistantOutput('msg-a1', 'OK')],
+        // The Responses API serialises attachments as a JSON-encoded
+        // string on the wire (transports flatten nested metadata).
+        metadata: {
+          attachments: JSON.stringify([
+            { fileName: 'report.pdf', fileId: 'f1', searchStoreId: 's1' },
+          ]),
+        },
+      }),
+    ]);
+
+    expect(tree.nodes['user-r1-0']!.metadata).toEqual({
+      responseId: 'r1',
+      attachments: [{ name: 'report.pdf', fileId: 'f1', searchStoreId: 's1' }],
+    });
+    // The assistant turn does not inherit attachments but still carries
+    // its responseId stamp.
+    expect(tree.nodes['msg-a1']!.metadata).toEqual({ responseId: 'r1' });
+  });
+
+  it('skips malformed metadata.attachments without polluting the tree', () => {
+    const warn = vi.spyOn(console, 'warn').mockImplementation(() => undefined);
+    try {
+      const tree = responsesToTree([
+        makeResponse({
+          id: 'r1',
+          request_input: [userInput('Hello')],
+          output: [assistantOutput('msg-a1', 'Hi')],
+          metadata: {
+            attachments: '{not json',
+          },
+        }),
+      ]);
+
+      // The malformed attachments are dropped, but `responseId` is still
+      // stamped on every node the adapter emits.
+      expect(tree.nodes['user-r1-0']!.metadata).toEqual({ responseId: 'r1' });
+      expect(tree.nodes['user-r1-0']!.metadata.attachments).toBeUndefined();
+      expect(warn).toHaveBeenCalled();
+    } finally {
+      warn.mockRestore();
+    }
+  });
+
   it('chains the next response under a reasoning-only assistant turn', () => {
     const tree = responsesToTree([
       makeResponse({

package/src/adapters/responses-api.ts

@@ -23,6 +23,7 @@ import { generateId } from '../helpers';
 import type {
   ConversationTree,
   MessageContent,
+  MessageMetadata,
   MessageRole,
   TreeMessage,
 } from '../types';
@@ -213,6 +214,22 @@ export interface ResponseAttachment {
   searchStoreId: string;
 }
 
+/**
+ * Render-side attachment shape produced by `responsesToTree`. Stored under
+ * `metadata.attachments` on the user `TreeMessage` (chat-kit's `BaseMessage`
+ * /`TreeMessage` carry `metadata` as an opaque `Record<string, unknown>`).
+ *
+ * The shape is intentionally minimal — a human-readable `name` plus the
+ * optional ids needed to resolve a public URL for the file. Consumers
+ * using a different attachment shape can either skip this adapter or
+ * project this onto their own type at the read site.
+ */
+export interface ResponseMessageAttachment {
+  name: string;
+  fileId?: string;
+  searchStoreId?: string;
+}
+
 /**
  * One stored response from the OpenAI-style Responses API, as returned by
  * `GET /conversations/:id/responses`. `previous_response_id` chains
@@ -230,7 +247,7 @@ export interface StoredResponse {
   output: ResponseOutput[];
   request_input: Record<string, unknown>[];
   metadata?: Record<string, unknown> & {
-    attachments?: ResponseAttachment[];
+    attachments?: string;
   };
   conversation?: { id: string };
   ancestor_ids?: string[];
@@ -252,11 +269,47 @@ export interface ResponseList {
 // Conversion: StoredResponse[] → ConversationTree
 // ---------------------------------------------------------------------------
 
+/**
+ * Per-node metadata produced by `responsesToTree`. The adapter is the
+ * single point that knows about the Responses-API wire format, so it
+ * stamps the originating `responseId` onto every node it emits. Anything
+ * downstream that reads it (typically a host app linking a tree message
+ * back to its server-side response) does so via this narrower metadata
+ * shape — chat-kit core stays oblivious to the field and treats it as
+ * opaque metadata.
+ */
+export type ResponseTreeMessageMetadata = MessageMetadata & {
+  responseId: string;
+  attachments?: ResponseMessageAttachment[];
+};
+
+/**
+ * Tree node emitted by `responsesToTree`. Structurally a `TreeMessage`,
+ * but with `metadata` narrowed to {@link ResponseTreeMessageMetadata} and
+ * promoted from optional to required: every node carries at least the
+ * originating `responseId`. Assignable to `TreeMessage` so the resulting
+ * tree can be passed directly to `useMessageHandler().setTree(...)`.
+ */
+export type ResponseTreeMessage = Omit<TreeMessage, 'metadata'> & {
+  metadata: ResponseTreeMessageMetadata;
+};
+
+/**
+ * `ConversationTree` returned by `responsesToTree`. Same shape as the
+ * core `ConversationTree`, with every node typed as a
+ * {@link ResponseTreeMessage} so callers can read `metadata.responseId`
+ * without re-narrowing. Structurally assignable to `ConversationTree`.
+ */
+export interface ResponseConversationTree extends ConversationTree {
+  nodes: Record<string, ResponseTreeMessage>;
+}
+
 interface ResponseMessageNode {
   id: string;
   role: MessageRole;
   content: MessageContent[];
   createdAt: Date;
+  metadata: ResponseTreeMessageMetadata;
 }
 
 function extractMessageText(parts: ResponseOutputTextPart[]): string {
@@ -373,6 +426,38 @@ function extractInputText(rawContent: unknown): string {
   return text.trim();
 }
 
+// Parse `resp.metadata.attachments` defensively. The Responses API
+// serialises the value as a JSON-encoded string (transports that persist
+// metadata flatten nested objects, so the array is stringified on the
+// wire). Returns `null` when the payload is missing, empty, or malformed —
+// callers treat that as "no attachments on this response". Malformed
+// payloads are logged via `console.warn` so consumers can spot upstream
+// serialisation issues.
+function parseResponseAttachments(
+  resp: StoredResponse,
+): ResponseAttachment[] | null {
+  const raw = resp.metadata?.attachments;
+  if (!raw) return null;
+
+  let attachments: unknown;
+  try {
+    attachments = JSON.parse(raw);
+  } catch {
+    // eslint-disable-next-line no-console
+    console.warn(
+      '[chat-kit] Failed to parse metadata.attachments as JSON; skipping.',
+      raw,
+    );
+    return null;
+  }
+
+  if (!Array.isArray(attachments) || attachments.length === 0) {
+    return null;
+  }
+
+  return attachments as ResponseAttachment[];
+}
+
 // Within a single response, the visible messages chain linearly: every user
 // input is followed by exactly one assistant turn (whose reasoning, tool,
 // and text outputs are merged into one node). Across responses, branching
@@ -380,21 +465,41 @@ function extractInputText(rawContent: unknown): string {
 // same parent and form sibling subtrees.
 function responseToMessageNodes(resp: StoredResponse): ResponseMessageNode[] {
   const nodes: ResponseMessageNode[] = [];
+  // Attachments are stored at the response level but logically belong to
+  // the user turn that started the response. We bind them to the first
+  // user `request_input` (mirroring the existing wire convention).
+  const responseAttachments = parseResponseAttachments(resp);
+  let userNodesPushed = 0;
   if (resp.request_input) {
     for (const [idx, input] of resp.request_input.entries()) {
       const role = (input as { role?: string }).role;
       const rawContent = (input as { content?: unknown }).content;
       const text = extractInputText(rawContent);
-      if (role === 'user' && text) {
-        nodes.push({
-          id: `user-${resp.id}-${idx}`,
-          role: 'user',
-          content: [textPart(text)],
-          createdAt: new Date(resp.created_at * 1000),
-        });
+      const userContent = text || responseAttachments?.length;
+      if (role !== 'user' || !userContent) continue;
+
+      const metadata: ResponseTreeMessageMetadata = { responseId: resp.id };
+      if (responseAttachments && userNodesPushed === 0) {
+        metadata.attachments = responseAttachments.map(
+          (a): ResponseMessageAttachment => ({
+            name: a.fileName,
+            fileId: a.fileId,
+            searchStoreId: a.searchStoreId,
+          }),
+        );
       }
+
+      nodes.push({
+        id: `user-${resp.id}-${idx}`,
+        role: 'user',
+        content: [textPart(text)],
+        createdAt: new Date(resp.created_at * 1000),
+        metadata,
+      });
+      userNodesPushed += 1;
     }
   }
+
   const assistantParts = toAssistantParts(resp);
   if (assistantParts.length > 0) {
     nodes.push({
@@ -402,6 +507,7 @@ function responseToMessageNodes(resp: StoredResponse): ResponseMessageNode[] {
       role: 'assistant',
       content: assistantParts,
       createdAt: new Date((resp.completed_at ?? resp.created_at) * 1000),
+      metadata: { responseId: resp.id },
     });
   }
   return nodes;
@@ -417,15 +523,19 @@ function responseToMessageNodes(resp: StoredResponse): ResponseMessageNode[] {
  * last message immediately. Sibling responses (same `previous_response_id`)
  * surface as branches; the latest one wins as the active branch.
  *
- * Pair with `useMessageHandler().setTree(responsesToTree(responses))` when
- * you want to hydrate a handler.
+ * Every emitted node carries `metadata.responseId` pointing back to the
+ * originating `StoredResponse.id` (see {@link ResponseTreeMessage}). The
+ * return type is assignable to `ConversationTree`, so you can pipe it
+ * straight into `useMessageHandler().setTree(...)`.
  */
-export function responsesToTree(responses: StoredResponse[]): ConversationTree {
+export function responsesToTree(
+  responses: StoredResponse[],
+): ResponseConversationTree {
   if (responses.length === 0) {
     return { nodes: {}, rootId: null };
   }
 
-  const treeNodes: Record<string, TreeMessage> = {};
+  const treeNodes: Record<string, ResponseTreeMessage> = {};
   // For each response, the id of its last visible message — that's the
   // attachment point for any future child response that chains onto it.
   // Empty responses fall back to their parent's attachment point so the
@@ -443,6 +553,7 @@ export function responsesToTree(responses: StoredResponse[]): ConversationTree {
       content: node.content,
       status: 'completed',
       createdAt: node.createdAt,
+      metadata: node.metadata,
     };
     if (parentId !== null) {
       const parent = treeNodes[parentId];