@aleph-alpha/chat-kit 1.3.1 → 1.5.0

package/src/types.ts

@@ -6,10 +6,63 @@ 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[];
@@ -22,7 +75,7 @@ export interface TreeMessage {
   childrenIds: string[];
   activeChildIndex: number;
   role: MessageRole;
-  content: string;
+  content: MessageContent[];
   status: MessageStatus;
   createdAt: Date;
 }

package/dist/ChatService-LogwJNxh.js

@@ -1,9 +0,0 @@
-class ChatService {
-  config;
-  constructor(config) {
-    this.config = config || {};
-  }
-}
-export {
-  ChatService as C
-};

package/dist/services/ChatService.d.ts

@@ -1,42 +0,0 @@
-import type { ChatConfig, ChatMessage, ChatResponse, StreamEvent } from './types';
-/**
- * Interface for chat service implementations
- *
- * This is a skeleton interface that defines the contract for chat services.
- * Implementations should provide concrete implementations of these methods.
- */
-export interface IChatService {
-    /**
-     * Send a message and receive a response
-     * @param message - The message to send
-     * @returns Promise resolving to the chat response
-     */
-    sendMessage(message: ChatMessage): Promise<ChatResponse>;
-    /**
-     * Get chat history
-     * @param limit - Maximum number of messages to retrieve
-     * @returns Promise resolving to an array of messages
-     */
-    getHistory(limit?: number): Promise<ChatMessage[]>;
-    /**
-     * Stream a message response
-     * @param message - The message to send
-     * @param onEvent - Callback for stream events
-     * @returns Promise that resolves when streaming is complete
-     */
-    streamMessage(message: ChatMessage, onEvent: (event: StreamEvent) => void): Promise<void>;
-}
-/**
- * Abstract base class for chat service implementations
- *
- * This is a skeleton abstract class that can be extended to create
- * concrete chat service implementations.
- */
-export declare abstract class ChatService implements IChatService {
-    protected config: ChatConfig;
-    constructor(config?: ChatConfig);
-    abstract sendMessage(message: ChatMessage): Promise<ChatResponse>;
-    abstract getHistory(limit?: number): Promise<ChatMessage[]>;
-    abstract streamMessage(message: ChatMessage, onEvent: (event: StreamEvent) => void): Promise<void>;
-}
-//# sourceMappingURL=ChatService.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ChatService.d.ts","sourceRoot":"","sources":["../../src/services/ChatService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzD;;;;OAIG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,aAAa,CACX,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;;GAKG;AACH,8BAAsB,WAAY,YAAW,YAAY;IACvD,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;gBAEjB,MAAM,CAAC,EAAE,UAAU;IAI/B,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IACjE,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3D,QAAQ,CAAC,aAAa,CACpB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC;CACjB"}

package/dist/services/MockChatService.d.ts

@@ -1,10 +0,0 @@
-import { ChatService, type IChatService } from './ChatService';
-import type { ChatMessage, ChatResponse, StreamEvent } from './types';
-export declare class MockChatService extends ChatService implements IChatService {
-    constructor();
-    sendMessage(message: ChatMessage): Promise<ChatResponse>;
-    getHistory(): Promise<ChatMessage[]>;
-    streamMessage(message: ChatMessage, onEvent: (event: StreamEvent) => void): Promise<void>;
-    private createBaseMessage;
-}
-//# sourceMappingURL=MockChatService.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"MockChatService.d.ts","sourceRoot":"","sources":["../../src/services/MockChatService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtE,qBAAa,eAAgB,SAAQ,WAAY,YAAW,YAAY;;IAKhE,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAYxD,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAIpC,aAAa,CACjB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC;IAMhB,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/useConversationSessions-ulFhtpQr.js

@@ -1,243 +0,0 @@
-import { g as generateId, u as useMessageHandler } from "./useMessageHandler-BmBdu2EW.js";
-import { ref, shallowRef, computed, readonly } from "vue";
-import "./purify.es-md74IFlY.js";
-function secondsToDate(seconds) {
-  return new Date(seconds * 1e3);
-}
-function toError(value) {
-  return value instanceof Error ? value : new Error(String(value));
-}
-function useChat() {
-}
-const DEFAULT_PAGE_SIZE = 20;
-function useConversations(options) {
-  const http = options.httpClient;
-  const path = options.path;
-  const pageSize = options.pageSize ?? DEFAULT_PAGE_SIZE;
-  const conversations = ref([]);
-  const inflightCount = shallowRef(0);
-  const isLoading = computed(() => inflightCount.value > 0);
-  const hasMore = shallowRef(false);
-  const error = shallowRef(null);
-  let nextCursor = null;
-  function beginRequest() {
-    inflightCount.value++;
-    error.value = null;
-  }
-  function endRequest() {
-    inflightCount.value--;
-  }
-  async function fetchPage(params) {
-    const query = {
-      limit: params.limit,
-      order: "desc"
-    };
-    if (params.cursor) query.after = params.cursor;
-    const raw = await http.get(path, { params: query });
-    return mapConversationList(raw);
-  }
-  async function fetch(opts) {
-    beginRequest();
-    try {
-      const page = await fetchPage({
-        limit: opts?.limit ?? pageSize,
-        cursor: null
-      });
-      conversations.value = page.items;
-      nextCursor = page.nextCursor;
-      hasMore.value = page.nextCursor !== null;
-    } catch (e) {
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  async function fetchMore() {
-    if (!hasMore.value || nextCursor === null) return;
-    beginRequest();
-    try {
-      const page = await fetchPage({ limit: pageSize, cursor: nextCursor });
-      conversations.value = [...conversations.value, ...page.items];
-      nextCursor = page.nextCursor;
-      hasMore.value = page.nextCursor !== null;
-    } catch (e) {
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  async function fetchById(id) {
-    beginRequest();
-    try {
-      const raw = await http.get(`${path}/${id}`);
-      return mapConversation(raw);
-    } catch (e) {
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  async function create(input, opts) {
-    const metadata = { ...input?.metadata ?? {} };
-    if (input?.title !== void 0) metadata.title = input.title;
-    const body = { metadata };
-    const previous = conversations.value;
-    let placeholder = null;
-    if (opts?.optimistic) {
-      placeholder = makePlaceholder(input?.title);
-      conversations.value = [placeholder, ...previous];
-    }
-    beginRequest();
-    try {
-      const raw = await http.post(path, body);
-      const created = mapConversation(raw);
-      conversations.value = placeholder ? conversations.value.map(
-        (c) => c.id === placeholder.id ? created : c
-      ) : [created, ...conversations.value];
-      return created;
-    } catch (e) {
-      if (placeholder) conversations.value = previous;
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  async function rename(id, title, opts) {
-    const previous = conversations.value;
-    if (opts?.optimistic) {
-      conversations.value = previous.map(
-        (c) => c.id === id ? { ...c, title, updatedAt: /* @__PURE__ */ new Date() } : c
-      );
-    }
-    beginRequest();
-    try {
-      const raw = await http.post(`${path}/${id}`, {
-        metadata: { title }
-      });
-      const updated = mapConversation(raw);
-      conversations.value = conversations.value.map(
-        (c) => c.id === id ? updated : c
-      );
-      return updated;
-    } catch (e) {
-      if (opts?.optimistic) conversations.value = previous;
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  async function remove(id, opts) {
-    const previous = conversations.value;
-    if (opts?.optimistic) {
-      conversations.value = previous.filter((c) => c.id !== id);
-    }
-    beginRequest();
-    try {
-      await http.delete(`${path}/${id}`);
-      if (!opts?.optimistic) {
-        conversations.value = previous.filter((c) => c.id !== id);
-      }
-    } catch (e) {
-      if (opts?.optimistic) conversations.value = previous;
-      error.value = toError(e);
-      throw error.value;
-    } finally {
-      endRequest();
-    }
-  }
-  function getById(id) {
-    return conversations.value.find((c) => c.id === id);
-  }
-  return {
-    conversations: readonly(conversations),
-    isLoading,
-    hasMore: readonly(hasMore),
-    error: readonly(error),
-    fetch,
-    fetchMore,
-    fetchById,
-    create,
-    rename,
-    remove,
-    getById
-  };
-}
-function mapConversation(raw) {
-  return {
-    id: raw.id,
-    title: raw.metadata?.title ?? "",
-    createdAt: secondsToDate(raw.created_at),
-    updatedAt: secondsToDate(raw.updated_at)
-  };
-}
-function mapConversationList(raw) {
-  return {
-    items: raw.data.map(mapConversation),
-    nextCursor: raw.has_more ? raw.last_id ?? null : null
-  };
-}
-function makePlaceholder(title) {
-  const now = /* @__PURE__ */ new Date();
-  return {
-    id: `pending-${generateId()}`,
-    title: title ?? "",
-    createdAt: now,
-    updatedAt: now
-  };
-}
-function useConversationSessions() {
-  const sessions = /* @__PURE__ */ new Map();
-  const focusedId = ref(null);
-  function createSession(conversationId) {
-    const existing = sessions.get(conversationId);
-    if (existing) return existing;
-    const session = {
-      id: conversationId,
-      messageHandler: useMessageHandler()
-    };
-    sessions.set(conversationId, session);
-    return session;
-  }
-  function getSession(conversationId) {
-    return sessions.get(conversationId);
-  }
-  function setActiveConversation(conversationId) {
-    if (conversationId === null) {
-      focusedId.value = null;
-      return;
-    }
-    createSession(conversationId);
-    focusedId.value = conversationId;
-  }
-  function removeSession(conversationId) {
-    sessions.delete(conversationId);
-    if (focusedId.value === conversationId) {
-      focusedId.value = null;
-    }
-  }
-  const activeSession = computed(() => {
-    const id = focusedId.value;
-    return id !== null ? sessions.get(id) ?? null : null;
-  });
-  const messageHandler = computed(
-    () => activeSession.value?.messageHandler ?? null
-  );
-  return {
-    activeSession,
-    messageHandler,
-    createSession,
-    getSession,
-    setActiveConversation,
-    removeSession
-  };
-}
-export {
-  useConversationSessions as a,
-  useConversations as b,
-  useChat as u
-};

package/src/services/ChatService.ts

@@ -1,60 +0,0 @@
-import type {
-  ChatConfig,
-  ChatMessage,
-  ChatResponse,
-  StreamEvent,
-} from './types';
-
-/**
- * Interface for chat service implementations
- *
- * This is a skeleton interface that defines the contract for chat services.
- * Implementations should provide concrete implementations of these methods.
- */
-export interface IChatService {
-  /**
-   * Send a message and receive a response
-   * @param message - The message to send
-   * @returns Promise resolving to the chat response
-   */
-  sendMessage(message: ChatMessage): Promise<ChatResponse>;
-
-  /**
-   * Get chat history
-   * @param limit - Maximum number of messages to retrieve
-   * @returns Promise resolving to an array of messages
-   */
-  getHistory(limit?: number): Promise<ChatMessage[]>;
-
-  /**
-   * Stream a message response
-   * @param message - The message to send
-   * @param onEvent - Callback for stream events
-   * @returns Promise that resolves when streaming is complete
-   */
-  streamMessage(
-    message: ChatMessage,
-    onEvent: (event: StreamEvent) => void,
-  ): Promise<void>;
-}
-
-/**
- * Abstract base class for chat service implementations
- *
- * This is a skeleton abstract class that can be extended to create
- * concrete chat service implementations.
- */
-export abstract class ChatService implements IChatService {
-  protected config: ChatConfig;
-
-  constructor(config?: ChatConfig) {
-    this.config = config || {};
-  }
-
-  abstract sendMessage(message: ChatMessage): Promise<ChatResponse>;
-  abstract getHistory(limit?: number): Promise<ChatMessage[]>;
-  abstract streamMessage(
-    message: ChatMessage,
-    onEvent: (event: StreamEvent) => void,
-  ): Promise<void>;
-}

package/src/services/MockChatService.ts

@@ -1,47 +0,0 @@
-import type { BaseMessage } from '../types';
-import { ChatService, type IChatService } from './ChatService';
-import type { ChatMessage, ChatResponse, StreamEvent } from './types';
-
-export class MockChatService extends ChatService implements IChatService {
-  constructor() {
-    super({});
-  }
-
-  async sendMessage(message: ChatMessage): Promise<ChatResponse> {
-    const replyText = `Mock reply: ${message.content}`;
-
-    return {
-      message: this.createBaseMessage({
-        role: 'assistant',
-        content: replyText,
-      }),
-      metadata: { mock: true },
-    };
-  }
-
-  async getHistory(): Promise<ChatMessage[]> {
-    return [];
-  }
-
-  async streamMessage(
-    message: ChatMessage,
-    onEvent: (event: StreamEvent) => void,
-  ): Promise<void> {
-    const response = await this.sendMessage(message);
-    onEvent({ type: 'chunk', data: response.message.content });
-    onEvent({ type: 'done' });
-  }
-
-  private createBaseMessage(input: {
-    role: BaseMessage['role'];
-    content: string;
-  }): BaseMessage {
-    return {
-      id: crypto.randomUUID(),
-      role: input.role,
-      content: input.content,
-      createdAt: new Date(),
-      status: 'completed',
-    };
-  }
-}