@aleph-alpha/chat-kit 1.11.1 → 1.12.0

package/dist/adapters/responses-api.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationTree } from '../types';
+import type { ConversationTree, MessageMetadata, TreeMessage } from '../types';
 /**
  * Annotation attached to a Responses-API content part (citations, file
  * references, etc.). chat-kit does not render annotations itself; the shape
@@ -157,6 +157,21 @@ export interface ResponseAttachment {
     fileName: string;
     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
@@ -174,7 +189,7 @@ export interface StoredResponse {
     output: ResponseOutput[];
     request_input: Record<string, unknown>[];
     metadata?: Record<string, unknown> & {
-        attachments?: ResponseAttachment[];
+        attachments?: string;
     };
     conversation?: {
         id: string;
@@ -192,6 +207,38 @@ export interface ResponseList {
     object: 'list';
     data: StoredResponse[];
 }
+/**
+ * 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>;
+}
 /**
  * Convert an OpenAI Responses API list (already ordered by `created_at`
  * ascending) into a chat-kit `ConversationTree`.
@@ -202,8 +249,10 @@ export interface ResponseList {
  * 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 declare function responsesToTree(responses: StoredResponse[]): ConversationTree;
+export declare function responsesToTree(responses: StoredResponse[]): ResponseConversationTree;
 //# sourceMappingURL=responses-api.d.ts.map

package/dist/adapters/responses-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses-api.d.ts","sourceRoot":"","sources":["../../src/adapters/responses-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"responses-api.d.ts","sourceRoot":"","sources":["../../src/adapters/responses-api.ts"],"names":[],"mappings":"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"}

package/dist/adapters/responses-api.js

@@ -83,21 +83,53 @@ function extractInputText(rawContent) {
   }
   return text.trim();
 }
+function parseResponseAttachments(resp) {
+  const raw = resp.metadata?.attachments;
+  if (!raw) return null;
+  let attachments;
+  try {
+    attachments = JSON.parse(raw);
+  } catch {
+    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;
+}
 function responseToMessageNodes(resp) {
   const nodes = [];
+  const responseAttachments = parseResponseAttachments(resp);
+  let userNodesPushed = 0;
   if (resp.request_input) {
     for (const [idx, input] of resp.request_input.entries()) {
       const role = input.role;
       const rawContent = input.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 * 1e3)
-        });
+      const userContent = text || responseAttachments?.length;
+      if (role !== "user" || !userContent) continue;
+      const metadata = { responseId: resp.id };
+      if (responseAttachments && userNodesPushed === 0) {
+        metadata.attachments = responseAttachments.map(
+          (a) => ({
+            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 * 1e3),
+        metadata
+      });
+      userNodesPushed += 1;
     }
   }
   const assistantParts = toAssistantParts(resp);
@@ -106,7 +138,8 @@ function responseToMessageNodes(resp) {
       id: getAssistantNodeId(resp),
       role: "assistant",
       content: assistantParts,
-      createdAt: new Date((resp.completed_at ?? resp.created_at) * 1e3)
+      createdAt: new Date((resp.completed_at ?? resp.created_at) * 1e3),
+      metadata: { responseId: resp.id }
     });
   }
   return nodes;
@@ -127,7 +160,8 @@ function responsesToTree(responses) {
       role: node.role,
       content: node.content,
       status: "completed",
-      createdAt: node.createdAt
+      createdAt: node.createdAt,
+      metadata: node.metadata
     };
     if (parentId !== null) {
       const parent = treeNodes[parentId];

package/dist/composables/index.js

@@ -1,4 +1,4 @@
-import { c, d, u, b, e, f } from "../index-BLq6_Lt2.js";
+import { c, d, u, b, e, f } from "../index-Ct5hD214.js";
 export {
   c as createDocumentUploadProvider,
   d as defaultDocumentUploadConfig,

package/dist/handlers/index.js

@@ -1,4 +1,4 @@
-import { u } from "../useMessageHandler-ZRC-gIOJ.js";
+import { u } from "../useMessageHandler-CMdy-lm0.js";
 import { C, d, p, u as u2, a } from "../useChatKitLabels-ftC52m7f.js";
 export {
   C as CHAT_KIT_LABELS,

package/dist/handlers/useMessageHandler.d.ts

@@ -1,4 +1,4 @@
-import type { BaseMessage, ConversationTree, MessageContent, MessageRole, MessageStatus } from '../types';
+import type { BaseMessage, ConversationTree, MessageContent, MessageMetadata, MessageRole, MessageStatus } from '../types';
 import { type Ref } from 'vue';
 export declare const useMessageHandler: () => {
     messages: Ref<BaseMessage[]>;
@@ -9,14 +9,18 @@ export declare const useMessageHandler: () => {
         content: MessageContent[];
         role: MessageRole;
         status: MessageStatus;
+        metadata?: MessageMetadata;
     }) => void;
     setCurrentUserMessage: (text: string) => void;
     getMessageById: (id: string) => BaseMessage | undefined;
     clearCurrentUserMessage: () => void;
-    commitUserMessage: () => BaseMessage;
+    commitUserMessage: (opts?: {
+        metadata?: MessageMetadata;
+    }) => BaseMessage;
     updateMessageId: (oldId: string, newId: string) => void;
     clearMessages: () => void;
     setTree: (incoming: ConversationTree) => void;
     navigate: (targetId: string) => void;
+    cutBranchAfter: (messageId: string) => void;
 };
 //# sourceMappingURL=useMessageHandler.d.ts.map

package/dist/handlers/useMessageHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMessageHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/useMessageHandler.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAElE,eAAO,MAAM,iBAAiB;cAuHJ,GAAG,CAAC,WAAW,EAAE,CAAC;;;6BApEV;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,aAAa,CAAC;KACvB;kCA7CoC,MAAM;yBAqEf,MAAM,KAAG,WAAW,GAAG,SAAS;;6BA7D9B,WAAW;6BAyET,MAAM,SAAS,MAAM;;wBAiB1B,gBAAgB;yBAKf,MAAM;CAkBnC,CAAC"}
+{"version":3,"file":"useMessageHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/useMessageHandler.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAElE,eAAO,MAAM,iBAAiB;cA6IJ,GAAG,CAAC,WAAW,EAAE,CAAC;;;6BArFV;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,aAAa,CAAC;QACtB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B;kCAnDoC,MAAM;yBAiFf,MAAM,KAAG,WAAW,GAAG,SAAS;;+BAzE1B;QAChC,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B,KAAG,WAAW;6BAqFiB,MAAM,SAAS,MAAM;;wBAiB1B,gBAAgB;yBAKf,MAAM;gCAQC,MAAM;CAmB1C,CAAC"}

package/dist/helpers/conversationTree.d.ts

@@ -6,8 +6,17 @@ export declare function createEmptyTree(): ConversationTree;
  */
 export declare function getLinearPath(tree: ConversationTree): BaseMessage[];
 export declare function addNode(tree: ConversationTree, node: TreeMessage): void;
-export declare function updateNode(tree: ConversationTree, id: string, updates: Partial<Pick<TreeMessage, 'content' | 'status' | 'role'>>): void;
+export declare function updateNode(tree: ConversationTree, id: string, updates: Partial<Pick<TreeMessage, 'content' | 'status' | 'role' | 'metadata'>>): void;
 export declare function updateNodeId(tree: ConversationTree, oldId: string, newId: string): void;
+/**
+ * Remove every descendant of the node with the given id, keeping the node
+ * itself intact. The node's `childrenIds` is cleared and `activeChildIndex`
+ * is reset to 0, which makes the node the new leaf of its branch.
+ *
+ * Useful when editing a message and discarding the conversation that was
+ * generated after it.
+ */
+export declare function cutBranchAfter(tree: ConversationTree, id: string): void;
 /**
  * Navigate to a different branch by updating the parent's activeChildIndex
  * to point at the target sibling.

package/dist/helpers/conversationTree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversationTree.d.ts","sourceRoot":"","sources":["../../src/helpers/conversationTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3E,wBAAgB,eAAe,IAAI,gBAAgB,CAElD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAkCnE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAYvE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,GACjE,IAAI,CAON;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWvE"}
+{"version":3,"file":"conversationTree.d.ts","sourceRoot":"","sources":["../../src/helpers/conversationTree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3E,wBAAgB,eAAe,IAAI,gBAAgB,CAElD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAmCnE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAYvE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CACd,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,CAC9D,GACA,IAAI,CAUN;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI,CAsBN;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAevE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWvE"}

package/dist/{index-BLq6_Lt2.js → index-Ct5hD214.js}

@@ -1,6 +1,6 @@
 import { g as generateId } from "./generateId-BHf0W4Rq.js";
 import { ref, shallowRef, computed, readonly, toRaw, toValue, watch } from "vue";
-import { u as useMessageHandler } from "./useMessageHandler-ZRC-gIOJ.js";
+import { u as useMessageHandler } from "./useMessageHandler-CMdy-lm0.js";
 import "./purify.es-md74IFlY.js";
 function secondsToDate(seconds) {
   return new Date(seconds * 1e3);

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { SdkError, createDocumentUploadProvider, defaultDocumentUploadConfig, de
 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 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,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,eAAe,EACf,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { u } from "./useMessageHandler-ZRC-gIOJ.js";
+import { u } from "./useMessageHandler-CMdy-lm0.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 { 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 } from "./CkInput.vue_vue_type_script_setup_true_lang-C1Jnn1fK.js";
 export {
   C as CHAT_KIT_LABELS,

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/{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.12.0",
   "description": "Chat kit package for building chat interfaces with Vue",
   "type": "module",
   "main": "./dist/index.js",

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({