@aleph-alpha/chat-kit 1.3.1 → 1.5.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { ChatService, type IChatService, type ChatConfig, type ChatMessage, type ChatResponse, type ConversationSummary, type HttpClient, type RawConversation, type RawConversationList, type StreamEvent, } from './services';
+export { type ChatConfig, type ChatMessage, type ChatResponse, type ConversationSummary, type HttpClient, type RawConversation, type RawConversationList, type StreamEvent, } from './services';
 export { useMessageHandler, useMarkdownParser, provideChatKitLabels, useChatKitLabels, defaultChatKitLabels, CHAT_KIT_LABELS, } from './handlers';
 export type { ChatKitLabels } from './handlers';
 export { useChat, useConversationSessions, useConversations, } from './composables';
 export type { ChatActions, ChatState, ConversationSession, CreateConversationInput, MessageHandler, MutationOptions, UseChatReturn, UseConversationSessionsReturn, UseConversationsOptions, UseConversationsReturn, } from './composables';
 export { CkAgentMessage, CkConversation, CkConversationLayout, CkCopyMessageActionButton, CkFeedbackButton, CkHistory, CkHistoryItem, CkHistoryWrapper, CkInput, CkMarkdownRenderer, CkMessageActionButton, CkPromptActionButton, CkPromptStopButton, CkPromptInput, CkPromptInputDisclaimer, CkSendIcon, CkStopIcon, CkUserMessage, } from './components';
 export type { CkConversationLayoutProps, CkConversationProps, CkFeedbackButtonProps, CkFeedbackValue, CkHistoryEmits, CkHistoryItemEmits, CkHistoryItemProps, CkHistoryProps, CkHistoryWrapperProps, CkMarkdownElementClasses, CkMarkdownRendererProps, CkUserMessageProps, } from './components';
-export type { BaseMessage, Conversation, ConversationTree, MessageRole, MessageStatus, TreeMessage, } from './types';
+export type { BaseMessage, Conversation, ConversationTree, MessageContent, MessageContentStatus, 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,WAAW,EACX,KAAK,YAAY,EACjB,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;AAGpB,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;AAGvB,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,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,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,WAAW,EACX,aAAa,EACb,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;AAGvB,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAChB,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,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"}

package/dist/index.js

@@ -1,15 +1,13 @@
-import { C } from "./ChatService-LogwJNxh.js";
-import { u } from "./useMessageHandler-BmBdu2EW.js";
-import { C as C2, d, p, u as u2, a } from "./useChatKitLabels-ftC52m7f.js";
-import { u as u3, a as a2, b } from "./useConversationSessions-ulFhtpQr.js";
-import { _, a as a3, b as b2, C as C3, c, d as d2, e, f, g, h, i, j, k, l, m, n, o, p as p2 } from "./CkInput.vue_vue_type_script_setup_true_lang-CyGLItQZ.js";
+import { u } from "./useMessageHandler-ZRC-gIOJ.js";
+import { C, d, p, u as u2, a } from "./useChatKitLabels-ftC52m7f.js";
+import { u as u3, a as a2, b } from "./index-BbTgIoYa.js";
+import { _, a as a3, b as b2, C as C2, c, d as d2, e, f, g, h, i, j, k, l, m, n, o, p as p2 } from "./CkInput.vue_vue_type_script_setup_true_lang-C5C09u0z.js";
 export {
-  C2 as CHAT_KIT_LABELS,
-  C as ChatService,
+  C as CHAT_KIT_LABELS,
   _ as CkAgentMessage,
   a3 as CkConversation,
   b2 as CkConversationLayout,
-  C3 as CkCopyMessageActionButton,
+  C2 as CkCopyMessageActionButton,
   c as CkFeedbackButton,
   d2 as CkHistory,
   e as CkHistoryItem,

package/dist/services/index.d.ts

@@ -1,4 +1,2 @@
-export { ChatService, type IChatService } from './ChatService';
-export { MockChatService } from './MockChatService';
 export type { ChatConfig, ChatMessage, ChatResponse, ConversationSummary, HttpClient, RawConversation, RawConversationList, StreamEvent, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/services/index.js

@@ -1,37 +1 @@
-import { C as ChatService } from "../ChatService-LogwJNxh.js";
-class MockChatService extends ChatService {
-  constructor() {
-    super({});
-  }
-  async sendMessage(message) {
-    const replyText = `Mock reply: ${message.content}`;
-    return {
-      message: this.createBaseMessage({
-        role: "assistant",
-        content: replyText
-      }),
-      metadata: { mock: true }
-    };
-  }
-  async getHistory() {
-    return [];
-  }
-  async streamMessage(message, onEvent) {
-    const response = await this.sendMessage(message);
-    onEvent({ type: "chunk", data: response.message.content });
-    onEvent({ type: "done" });
-  }
-  createBaseMessage(input) {
-    return {
-      id: crypto.randomUUID(),
-      role: input.role,
-      content: input.content,
-      createdAt: /* @__PURE__ */ new Date(),
-      status: "completed"
-    };
-  }
-}
-export {
-  ChatService,
-  MockChatService
-};
+

package/dist/services/types.d.ts

@@ -1,4 +1,4 @@
-import type { BaseMessage, MessageRole } from '../types';
+import type { BaseMessage, MessageContent, MessageRole } from '../types';
 /**
  * Minimal HTTP transport contract that chat-kit composables depend on.
  *
@@ -58,7 +58,7 @@ export interface RawConversationList {
 export interface ChatMessage {
     id: string;
     role: MessageRole;
-    content: string;
+    content: MessageContent[];
 }
 /**
  * Response from the chat service

package/dist/services/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/services/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EACH,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC7C,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/services/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,EACH,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC7C,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/dist/types.d.ts

@@ -3,10 +3,55 @@
  */
 export type MessageRole = 'user' | 'assistant' | 'system';
 export type MessageStatus = 'started' | 'sending' | 'completed' | 'error';
+/**
+ * Lifecycle of a single content item inside a message — used to indicate
+ * whether a streamed text part is still being produced, has finished, or was
+ * cut short. Tool content does not carry a status (it represents a single
+ * fired tool call) so it always omits this field.
+ */
+export type MessageContentStatus = 'in_progress' | 'completed' | 'incomplete';
+/**
+ * Plain text part of a message. Multiple text parts can appear in a single
+ * assistant turn, interleaved with reasoning and tool calls.
+ */
+export interface MessageTextContent {
+    type: 'text';
+    id: string;
+    text: string;
+    status: MessageContentStatus;
+}
+/**
+ * Tool invocation triggered by the assistant during its turn. Only the tool
+ * name is rendered; arguments and results are intentionally outside the
+ * UI-facing model and should be tracked by the host application.
+ */
+export interface MessageToolContent {
+    type: 'tool';
+    id: string;
+    name: string;
+}
+/**
+ * Chain-of-thought / reasoning segment produced by the assistant. `text` is
+ * the (optional) human-readable trail — populated when the underlying
+ * transport exposes reasoning content (`REASONING_MESSAGE_CONTENT` deltas
+ * during a live run, `reasoning_text` parts when re-hydrating from the
+ * Responses API). Surfaces that only need a "Thinking…" / "Thought"
+ * indicator can ignore it and rely on `status` alone.
+ */
+export interface MessageReasoningContent {
+    type: 'reasoning';
+    id: string;
+    text?: string;
+    status: MessageContentStatus;
+}
+/**
+ * Discriminated union of all content parts that can appear inside a message.
+ */
+export type MessageContent = MessageTextContent | MessageToolContent | MessageReasoningContent;
 export interface BaseMessage {
     id: string;
     role: MessageRole;
-    content: string;
+    content: MessageContent[];
     createdAt: Date;
     status: MessageStatus;
     siblingIds?: string[];
@@ -18,7 +63,7 @@ export interface TreeMessage {
     childrenIds: string[];
     activeChildIndex: number;
     role: MessageRole;
-    content: string;
+    content: MessageContent[];
     status: MessageStatus;
     createdAt: Date;
 }

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,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,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,MAAM,CAAC;IAChB,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;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;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"}

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

@@ -1,3 +1,4 @@
+import { g as generateId } from "./generateId-BHf0W4Rq.js";
 import { reactive, ref, computed, readonly } from "vue";
 function createEmptyTree() {
   return { nodes: {}, rootId: null };
@@ -77,9 +78,6 @@ function navigate(tree, targetId) {
   if (idx === -1) return;
   parent.activeChildIndex = idx;
 }
-function generateId() {
-  return typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : String(Date.now());
-}
 const useMessageHandler = () => {
   const tree = reactive(createEmptyTree());
   const currentUserMessage = ref("");
@@ -98,13 +96,16 @@ const useMessageHandler = () => {
     const id = generateId();
     const text = currentUserMessage.value.trim();
     if (!text) throw new Error("No message");
+    const content = [
+      { type: "text", id: generateId(), text, status: "completed" }
+    ];
     const node = {
       id,
       parentId: currentLeafId.value,
       childrenIds: [],
       activeChildIndex: 0,
       role: "user",
-      content: text,
+      content,
       status: "completed",
       createdAt: /* @__PURE__ */ new Date()
     };
@@ -180,6 +181,5 @@ const useMessageHandler = () => {
   };
 };
 export {
-  generateId as g,
   useMessageHandler as u
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aleph-alpha/chat-kit",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "Chat kit package for building chat interfaces with Vue",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,14 @@
     "./handlers": {
       "import": "./dist/handlers/index.js",
       "types": "./dist/handlers/index.d.ts"
+    },
+    "./adapters": {
+      "import": "./dist/adapters/index.js",
+      "types": "./dist/adapters/index.d.ts"
+    },
+    "./adapters/responses-api": {
+      "import": "./dist/adapters/responses-api.js",
+      "types": "./dist/adapters/responses-api.d.ts"
     }
   },
   "files": [
@@ -64,7 +72,7 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "unified": "^11.0.5",
-    "@aleph-alpha/ui-library": "2.4.2"
+    "@aleph-alpha/ui-library": "2.4.3"
   },
   "devDependencies": {
     "@storybook/addon-a11y": "10.2.17",

package/src/adapters/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Format adapters for chat-kit.
+ *
+ * Adapters convert a transport-specific transcript shape into chat-kit's
+ * domain model (`ConversationTree`). They are intentionally optional — the
+ * message handler only knows about `setTree(tree)`, so apps that use a
+ * different format can write their own adapter (or skip the concept
+ * entirely and build trees by hand).
+ *
+ * Currently shipped:
+ *  - `responses-api` — OpenAI-style `GET /conversations/{id}/responses`.
+ *
+ * Re-exported via `@aleph-alpha/chat-kit/adapters`. Use the more granular
+ * `@aleph-alpha/chat-kit/adapters/responses-api` subpath when you only
+ * need a specific adapter.
+ */
+export * from './responses-api';

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

@@ -0,0 +1,365 @@
+import { useMessageHandler } from '../handlers/useMessageHandler';
+import type { MessageContent, MessageTextContent } from '../types';
+import {
+  responsesToTree,
+  type ResponseOutputMessage,
+  type ResponseOutputReasoning,
+  type ResponseOutputTool,
+  type StoredResponse,
+} from './responses-api';
+
+function getText(content: MessageContent[]): string {
+  return content
+    .filter((c): c is MessageTextContent => c.type === 'text')
+    .map((c) => c.text)
+    .join('');
+}
+
+function makeResponse(
+  overrides: Partial<StoredResponse> & { id: string },
+): StoredResponse {
+  return {
+    object: 'response',
+    created_at: 1_777_456_700,
+    completed_at: 1_777_456_701,
+    status: 'completed',
+    model: 'pharia-1',
+    output: [],
+    request_input: [],
+    ...overrides,
+  };
+}
+
+function userInput(text: string): Record<string, unknown> {
+  return { role: 'user', content: text };
+}
+
+function assistantOutput(id: string, text: string): ResponseOutputMessage {
+  return {
+    type: 'message',
+    id,
+    status: 'completed',
+    role: 'assistant',
+    content: [{ type: 'output_text', text }],
+  };
+}
+
+function reasoningOutput(id: string, text: string): ResponseOutputReasoning {
+  return {
+    type: 'reasoning',
+    id,
+    status: 'completed',
+    role: null,
+    content: [{ type: 'reasoning_text', text }],
+  };
+}
+
+function toolOutput(
+  overrides: Partial<ResponseOutputTool> & { id: string },
+): ResponseOutputTool {
+  return {
+    type: 'mcp_list_tools',
+    server_label: 'firecrawl',
+    tools: [],
+    ...overrides,
+  };
+}
+
+describe('responsesToTree', () => {
+  it('returns an empty tree for an empty response list', () => {
+    expect(responsesToTree([])).toEqual({ nodes: {}, rootId: null });
+  });
+
+  it('builds a linear tree from a single response with one user input and one assistant output', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [assistantOutput('msg-a1', 'Hi there')],
+      }),
+    ]);
+
+    const ids = Object.keys(tree.nodes);
+    expect(ids).toHaveLength(2);
+
+    const userNode = tree.nodes['user-r1-0']!;
+    expect(userNode.role).toBe('user');
+    expect(userNode.parentId).toBeNull();
+    expect(getText(userNode.content)).toBe('Hello');
+
+    const assistantNode = tree.nodes['msg-a1']!;
+    expect(assistantNode.role).toBe('assistant');
+    expect(assistantNode.parentId).toBe('user-r1-0');
+    expect(getText(assistantNode.content)).toBe('Hi there');
+
+    expect(tree.rootId).toBe('user-r1-0');
+  });
+
+  it('chains a follow-up response under the previous assistant message via previous_response_id', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('First')],
+        output: [assistantOutput('msg-a1', 'A1')],
+      }),
+      makeResponse({
+        id: 'r2',
+        previous_response_id: 'r1',
+        request_input: [userInput('Second')],
+        output: [assistantOutput('msg-a2', 'A2')],
+      }),
+    ]);
+
+    expect(tree.nodes['user-r2-0']!.parentId).toBe('msg-a1');
+    expect(tree.nodes['msg-a2']!.parentId).toBe('user-r2-0');
+    expect(tree.rootId).toBe('user-r1-0');
+  });
+
+  it('treats sibling responses (same previous_response_id) as branches and surfaces the latest as active', () => {
+    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('Branch A')],
+        output: [assistantOutput('msg-a2', 'A')],
+      }),
+      makeResponse({
+        id: 'r3',
+        previous_response_id: 'r1',
+        request_input: [userInput('Branch B')],
+        output: [assistantOutput('msg-a3', 'B')],
+      }),
+    ]);
+
+    const a1 = tree.nodes['msg-a1']!;
+    expect(a1.childrenIds).toEqual(['user-r2-0', 'user-r3-0']);
+    expect(a1.activeChildIndex).toBe(1);
+  });
+
+  it('skips responses with no visible content but keeps descendants attached to the parent tail', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [assistantOutput('msg-a1', 'Hi')],
+      }),
+      makeResponse({
+        id: 'r2',
+        previous_response_id: 'r1',
+        request_input: [],
+        output: [],
+      }),
+      makeResponse({
+        id: 'r3',
+        previous_response_id: 'r2',
+        request_input: [userInput('Follow-up')],
+        output: [assistantOutput('msg-a3', 'Reply')],
+      }),
+    ]);
+
+    expect(tree.nodes['user-r3-0']!.parentId).toBe('msg-a1');
+  });
+
+  it('extracts text from string content as well as output_text / text parts', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('plain string')],
+        output: [
+          {
+            type: 'message',
+            id: 'msg-mixed',
+            status: 'completed',
+            role: 'assistant',
+            content: [
+              { type: 'output_text', text: 'first ' },
+              { type: 'reasoning_summary', text: 'should-be-ignored' },
+              { type: 'text', text: 'second' },
+            ],
+          },
+        ],
+      }),
+    ]);
+
+    expect(getText(tree.nodes['user-r1-0']!.content)).toBe('plain string');
+    expect(getText(tree.nodes['msg-mixed']!.content)).toBe('first second');
+  });
+
+  it('merges reasoning, tool calls, and message text into a single assistant node, preserving wire order', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          toolOutput({
+            id: 'tool-list',
+            type: 'mcp_list_tools',
+            server_label: 'firecrawl',
+            tools: [{ name: 'firecrawl_scrape' }],
+          }),
+          reasoningOutput('rs-1', 'thinking out loud'),
+          toolOutput({
+            id: 'tool-call-1',
+            type: 'mcp_call',
+            name: 'firecrawl_scrape',
+          }),
+          assistantOutput('msg-a1', 'Hi'),
+        ],
+      }),
+    ]);
+
+    // Reasoning and tool items don't get their own tree nodes; they are
+    // rolled up onto the assistant message.
+    expect(tree.nodes['tool-list']).toBeUndefined();
+    expect(tree.nodes['rs-1']).toBeUndefined();
+    expect(tree.nodes['tool-call-1']).toBeUndefined();
+
+    const assistant = tree.nodes['msg-a1']!;
+    expect(assistant).toBeDefined();
+    // mcp_list_tools is informational and skipped; reasoning + mcp_call +
+    // text remain in their original order.
+    expect(assistant.content).toHaveLength(3);
+    expect(assistant.content[0]).toMatchObject({
+      type: 'reasoning',
+      id: 'rs-1',
+      text: 'thinking out loud',
+      status: 'completed',
+    });
+    expect(assistant.content[1]).toMatchObject({
+      type: 'tool',
+      id: 'tool-call-1',
+      name: 'firecrawl_scrape',
+    });
+    expect(assistant.content[2]).toMatchObject({
+      type: 'text',
+      id: 'msg-a1',
+      text: 'Hi',
+      status: 'completed',
+    });
+  });
+
+  it('also picks up function_call / tool_call outputs as tool parts', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          toolOutput({ id: 'fn-1', type: 'function_call', name: 'lookup' }),
+          toolOutput({ id: 'tc-1', type: 'tool_call', name: 'shell' }),
+          assistantOutput('msg-a1', 'Done'),
+        ],
+      }),
+    ]);
+
+    const assistant = tree.nodes['msg-a1']!;
+    expect(assistant.content).toHaveLength(3);
+    expect(assistant.content[0]).toMatchObject({
+      type: 'tool',
+      id: 'fn-1',
+      name: 'lookup',
+    });
+    expect(assistant.content[1]).toMatchObject({
+      type: 'tool',
+      id: 'tc-1',
+      name: 'shell',
+    });
+    expect(assistant.content[2].type).toBe('text');
+  });
+
+  it('creates an assistant node from reasoning / tool outputs even when no message output is present', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          reasoningOutput('rs-1', 'planning'),
+          toolOutput({ id: 'tool-1', type: 'mcp_call', name: 'search' }),
+        ],
+      }),
+    ]);
+
+    const assistant = tree.nodes['assistant-r1']!;
+    expect(assistant).toBeDefined();
+    expect(assistant.role).toBe('assistant');
+    expect(assistant.content).toHaveLength(2);
+    expect(assistant.content[0]).toMatchObject({
+      type: 'reasoning',
+      text: 'planning',
+    });
+    expect(assistant.content[1].type).toBe('tool');
+  });
+
+  it('omits reasoning text when no reasoning_text parts are present', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [
+          {
+            type: 'reasoning',
+            id: 'rs-empty',
+            status: 'completed',
+            role: null,
+            content: [],
+          },
+          assistantOutput('msg-a1', 'Hi'),
+        ],
+      }),
+    ]);
+
+    const reasoning = tree.nodes['msg-a1']!.content[0];
+    expect(reasoning.type).toBe('reasoning');
+    if (reasoning.type === 'reasoning') {
+      expect(reasoning.text).toBeUndefined();
+    }
+  });
+
+  it('chains the next response under a reasoning-only assistant turn', () => {
+    const tree = responsesToTree([
+      makeResponse({
+        id: 'r1',
+        request_input: [userInput('Hello')],
+        output: [reasoningOutput('rs-1', 'planning')],
+      }),
+      makeResponse({
+        id: 'r2',
+        previous_response_id: 'r1',
+        request_input: [userInput('Follow-up')],
+        output: [assistantOutput('msg-a2', 'Reply')],
+      }),
+    ]);
+
+    expect(tree.nodes['rs-1']).toBeUndefined();
+    expect(tree.nodes['assistant-r1']).toBeDefined();
+    expect(tree.nodes['user-r2-0']!.parentId).toBe('assistant-r1');
+    expect(tree.nodes['msg-a2']!.parentId).toBe('user-r2-0');
+  });
+});
+
+describe('responsesToTree + useMessageHandler.setTree', () => {
+  it('hydrates a handler from a Responses-API list via the documented adapter pattern', () => {
+    const handler = useMessageHandler();
+    handler.setTree(
+      responsesToTree([
+        makeResponse({
+          id: 'r1',
+          request_input: [userInput('Hello')],
+          output: [assistantOutput('msg-a1', 'Hi')],
+        }),
+      ]),
+    );
+
+    expect(handler.messages.value).toHaveLength(2);
+    expect(handler.messages.value.map((m) => m.role)).toEqual([
+      'user',
+      'assistant',
+    ]);
+    expect(getText(handler.messages.value[0].content)).toBe('Hello');
+    expect(getText(handler.messages.value[1].content)).toBe('Hi');
+  });
+});