@truedat/ai 8.5.4 → 8.5.6

package/src/components/assistant/__tests__/AssistantChat.spec.js

@@ -25,6 +25,24 @@ describe("<AssistantChat />", () => {
     expect(rendered.container).toMatchSnapshot();
   });
 
+  it("shows the title in the header when provided", async () => {
+    const rendered = render(
+      <AssistantChat {...defaultProps} title="My Conversation Title" />
+    );
+    await waitForLoad(rendered);
+
+    expect(rendered.getByText("My Conversation Title")).toBeInTheDocument();
+  });
+
+  it("shows default new conversation text when title is not provided", async () => {
+    const rendered = render(<AssistantChat {...defaultProps} title={null} />);
+    await waitForLoad(rendered);
+
+    expect(
+      rendered.getByText("assistant.newConversation")
+    ).toBeInTheDocument();
+  });
+
   it("groups logs in a thinking block and auto-collapses when a priority-0 response arrives", async () => {
     const conversation = [
       {

package/src/components/assistant/__tests__/AssistantConversations.spec.js

@@ -0,0 +1,111 @@
+import React from "react";
+import { fireEvent } from "@testing-library/react";
+import { render, waitForLoad } from "@truedat/test/render";
+
+import AssistantConversations from "../AssistantConversations";
+
+const conversations = [
+  {
+    id: 1,
+    updated_at: "2026-04-23T10:00:00Z",
+    title: "Data governance overview",
+    preview: "How does data governance work?",
+  },
+  {
+    id: 2,
+    updated_at: "2026-04-22T08:30:00Z",
+    title: null,
+    preview: "What is a data domain?",
+  },
+  {
+    id: 3,
+    updated_at: "2026-04-21T08:30:00Z",
+    title: null,
+    preview: null,
+  },
+];
+
+const defaultProps = {
+  conversations,
+  activeId: null,
+  onSelect: jest.fn(),
+  onNewConversation: jest.fn(),
+};
+
+describe("<AssistantConversations />", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("matches the latest snapshot", async () => {
+    const rendered = render(<AssistantConversations {...defaultProps} />);
+    await waitForLoad(rendered);
+    expect(rendered.container).toMatchSnapshot();
+  });
+
+  it("renders all conversations", async () => {
+    const rendered = render(<AssistantConversations {...defaultProps} />);
+    await waitForLoad(rendered);
+
+    expect(rendered.getByText("Data governance overview")).toBeInTheDocument();
+    expect(rendered.getByText("What is a data domain?")).toBeInTheDocument();
+    expect(
+      rendered.getByText("assistant.conversation.noPreview")
+    ).toBeInTheDocument();
+  });
+
+  it("shows title when available, falling back to preview then placeholder", async () => {
+    const rendered = render(<AssistantConversations {...defaultProps} />);
+    await waitForLoad(rendered);
+
+    const items = rendered.container.querySelectorAll(
+      ".ai-conversation-list__item-preview"
+    );
+    expect(items[0]).toHaveTextContent("Data governance overview");
+    expect(items[1]).toHaveTextContent("What is a data domain?");
+    expect(items[2]).toHaveTextContent("assistant.conversation.noPreview");
+  });
+
+  it("marks the active conversation", async () => {
+    const rendered = render(
+      <AssistantConversations {...defaultProps} activeId={1} />
+    );
+    await waitForLoad(rendered);
+
+    const items = rendered.container.querySelectorAll(
+      ".ai-conversation-list__item"
+    );
+    expect(items[0]).toHaveClass("ai-conversation-list__item--active");
+    expect(items[1]).not.toHaveClass("ai-conversation-list__item--active");
+  });
+
+  it("calls onSelect with conversation id when an item is clicked", async () => {
+    const onSelect = jest.fn();
+    const rendered = render(
+      <AssistantConversations {...defaultProps} onSelect={onSelect} />
+    );
+    await waitForLoad(rendered);
+
+    const items = rendered.container.querySelectorAll(
+      ".ai-conversation-list__item"
+    );
+    fireEvent.click(items[0]);
+    expect(onSelect).toHaveBeenCalledWith(1);
+  });
+
+  it("calls onNewConversation when the new button is clicked", async () => {
+    const onNewConversation = jest.fn();
+    const rendered = render(
+      <AssistantConversations
+        {...defaultProps}
+        onNewConversation={onNewConversation}
+      />
+    );
+    await waitForLoad(rendered);
+
+    fireEvent.click(
+      rendered.container.querySelector(".ai-conversation-list__new")
+    );
+    expect(onNewConversation).toHaveBeenCalled();
+  });
+});

package/src/components/assistant/__tests__/__snapshots__/Assistant.spec.js.snap

@@ -3,19 +3,19 @@
 exports[`<Assistant /> matches the latest snapshot when socket is ready 1`] = `
 <div>
   <div
-    class="assistant-container assistant-container--closed"
+    class="assistant-container"
   >
-    <div
+    <button
+      aria-expanded="false"
       aria-label="assistant.bubble.label"
       class="assistant-bubble"
-      role="button"
-      tabindex="0"
+      type="button"
     >
       <i
         aria-hidden="true"
         class="comments icon"
       />
-    </div>
+    </button>
   </div>
 </div>
 `;

package/src/components/assistant/__tests__/__snapshots__/AssistantChat.spec.js.snap

@@ -6,28 +6,38 @@ exports[`<AssistantChat /> matches the latest snapshot 1`] = `
     class="assistant-chat"
   >
     <div
-      class="assistant-chat__actions"
+      class="assistant-chat__header"
     >
+      <span
+        class="assistant-chat__header-title"
+      >
+        assistant.newConversation
+      </span>
       <button
-        aria-label="assistant.actions.newChat"
-        class="assistant-chat__action assistant-chat__action--new-chat"
+        aria-label="assistant.actions.close"
+        class="assistant-chat__action assistant-chat__action--close"
         type="button"
       >
         <i
           aria-hidden="true"
-          class="comment outline icon"
+          class="close icon"
         />
-        assistant.actions.newChat
       </button>
+    </div>
+    <div
+      class="assistant-chat__actions"
+    >
       <button
-        aria-label="assistant.actions.close"
-        class="assistant-chat__action assistant-chat__action--close"
+        aria-label="assistant.actions.newChat"
+        class="assistant-chat__action"
+        title="assistant.actions.newChat"
         type="button"
       >
         <i
           aria-hidden="true"
-          class="close icon"
+          class="comment outline icon"
         />
+        assistant.actions.newChat
       </button>
     </div>
     <div

package/src/components/assistant/__tests__/__snapshots__/AssistantConversations.spec.js.snap

@@ -0,0 +1,73 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`<AssistantConversations /> matches the latest snapshot 1`] = `
+<div>
+  <div
+    class="ai-conversation-list"
+  >
+    <div
+      class="ai-conversation-list__header"
+    >
+      <button
+        class="ai-conversation-list__new"
+        type="button"
+      >
+        <i
+          aria-hidden="true"
+          class="edit outline icon"
+        />
+        assistant.newConversation
+      </button>
+    </div>
+    <div
+      class="ai-conversation-list__items"
+    >
+      <button
+        class="ai-conversation-list__item"
+        type="button"
+      >
+        <span
+          class="ai-conversation-list__item-preview"
+        >
+          Data governance overview
+        </span>
+        <span
+          class="ai-conversation-list__item-date"
+        >
+          Apr 23, 10:00 AM
+        </span>
+      </button>
+      <button
+        class="ai-conversation-list__item"
+        type="button"
+      >
+        <span
+          class="ai-conversation-list__item-preview"
+        >
+          What is a data domain?
+        </span>
+        <span
+          class="ai-conversation-list__item-date"
+        >
+          Apr 22, 08:30 AM
+        </span>
+      </button>
+      <button
+        class="ai-conversation-list__item"
+        type="button"
+      >
+        <span
+          class="ai-conversation-list__item-preview"
+        >
+          assistant.conversation.noPreview
+        </span>
+        <span
+          class="ai-conversation-list__item-date"
+        >
+          Apr 21, 08:30 AM
+        </span>
+      </button>
+    </div>
+  </div>
+</div>
+`;

package/src/components/assistant/hooks/useAgentConversation.js

@@ -4,8 +4,10 @@ import { apiJsonPost } from "@truedat/core/services/api";
 
 import { API_AGENT_LAYER_CONVERSATION } from "../../../api";
 
-const useAgentConversation = (isOpen) => {
-  const [conversationId, setConversationId] = useState(null);
+const useAgentConversation = (isOpen, initialId = null) => {
+  const [conversationId, setConversationId] = useState(
+    initialId != null ? String(initialId) : null
+  );
 
   useEffect(() => {
     if (!isOpen || conversationId != null) return;
@@ -32,7 +34,11 @@ const useAgentConversation = (isOpen) => {
     setConversationId(null);
   }, []);
 
-  return { conversationId, startNewConversation };
+  const selectConversation = useCallback((id) => {
+    setConversationId(String(id));
+  }, []);
+
+  return { conversationId, startNewConversation, selectConversation };
 };
 
 export default useAgentConversation;

package/src/components/assistant/hooks/useAssistantSocket.js

@@ -10,7 +10,14 @@ const CONNECT_DELAY_MS = 150;
 const RECONNECT_DELAY_MS = 2000;
 
 const useAssistantSocket = (disabled = false, options = {}) => {
-  const { conversationId = null, onChannelJoined, onServerMessage } = options;
+  const {
+    conversationId = null,
+    onChannelJoined,
+    onServerMessage,
+    assistantName = null,
+    welcomeMessage = null,
+    exact = false,
+  } = options;
   const [socketReady, setSocketReady] = useState(false);
   const socketRef = useRef(null);
   const channelRef = useRef(null);
@@ -65,7 +72,17 @@ const useAssistantSocket = (disabled = false, options = {}) => {
   useEffect(() => {
     if (!socketReady || !conversationId || !socketRef.current) return;
     const topic = `agent_layer:${conversationId}`;
-    const channel = socketRef.current.channel(topic, {});
+    const locale = navigator.language || "en-US";
+    const localHour = new Date().getHours();
+    const channelParams = {
+      locale,
+      local_hour: localHour,
+      assistant_name: assistantName,
+      welcome_message: welcomeMessage,
+      exact,
+    };
+
+    const channel = socketRef.current.channel(topic, channelParams);
     channelRef.current = channel;
 
     const handleEvent = (event, payload) => {
@@ -81,6 +98,12 @@ const useAssistantSocket = (disabled = false, options = {}) => {
     const refStream = channel.on("stream", (payload) =>
       handleEvent("stream", payload),
     );
+    const refHistory = channel.on("history", (payload) =>
+      handleEvent("history", payload),
+    );
+    const refTitle = channel.on("title", (payload) =>
+      handleEvent("title", payload),
+    );
 
     channel
       .join()
@@ -93,10 +116,20 @@ const useAssistantSocket = (disabled = false, options = {}) => {
       channel.off("log", refLog);
       channel.off("error", refError);
       channel.off("stream", refStream);
+      channel.off("history", refHistory);
+      channel.off("title", refTitle);
       channelRef.current = null;
       channel.leave();
     };
-  }, [socketReady, conversationId, onChannelJoined, onServerMessage]);
+  }, [
+    socketReady,
+    conversationId,
+    onChannelJoined,
+    onServerMessage,
+    assistantName,
+    welcomeMessage,
+    exact,
+  ]);
 
   const sendPrompt = useCallback(
     (prompt) => {

package/src/components/index.js

@@ -1,5 +1,6 @@
 import AiRoutes from "./AiRoutes";
 import TranslationModal from "./TranslationModal";
 import Assistant from "./assistant/Assistant";
+import AssistantPage from "./assistant/AssistantPage";
 import ThinkingOutLoud, { getSourceLabel } from "./ThinkingOutLoud";
-export { AiRoutes, TranslationModal, Assistant, ThinkingOutLoud, getSourceLabel };
+export { AiRoutes, TranslationModal, Assistant, AssistantPage, ThinkingOutLoud, getSourceLabel };

package/src/hooks/__tests__/useAgentConversations.spec.js

@@ -0,0 +1,83 @@
+import useSWR from "swr";
+import { renderHook } from "@testing-library/react";
+import { apiJson } from "@truedat/core/services/api";
+import { API_AGENT_LAYER_CONVERSATIONS } from "../../api";
+import useAgentConversations from "../useAgentConversations";
+
+jest.mock("swr", () => ({
+  __esModule: true,
+  default: jest.fn(),
+}));
+
+jest.mock("@truedat/core/services/api", () => ({
+  __esModule: true,
+  ...jest.requireActual("@truedat/core/services/api"),
+  apiJson: jest.fn(),
+}));
+
+describe("useAgentConversations", () => {
+  const mockMutate = jest.fn();
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it("calls useSWR with the correct endpoint and fetcher", () => {
+    useSWR.mockReturnValue({ data: undefined, error: null, mutate: mockMutate });
+    renderHook(() => useAgentConversations());
+
+    expect(useSWR).toHaveBeenCalledWith(API_AGENT_LAYER_CONVERSATIONS, apiJson);
+  });
+
+  it("returns conversations from nested data.data response", () => {
+    const conversations = [{ id: 1, preview: "Hello" }];
+    useSWR.mockReturnValue({
+      data: { data: { data: conversations } },
+      error: null,
+      mutate: mockMutate,
+    });
+
+    const { result } = renderHook(() => useAgentConversations());
+    expect(result.current.conversations).toEqual(conversations);
+  });
+
+  it("returns conversations from flat data response", () => {
+    const conversations = [{ id: 2, preview: "World" }];
+    useSWR.mockReturnValue({
+      data: { data: conversations },
+      error: null,
+      mutate: mockMutate,
+    });
+
+    const { result } = renderHook(() => useAgentConversations());
+    expect(result.current.conversations).toEqual(conversations);
+  });
+
+  it("returns empty array when data is undefined", () => {
+    useSWR.mockReturnValue({ data: undefined, error: null, mutate: mockMutate });
+
+    const { result } = renderHook(() => useAgentConversations());
+    expect(result.current.conversations).toEqual([]);
+    expect(result.current.loading).toBe(true);
+  });
+
+  it("returns error state when fetch fails", () => {
+    const error = new Error("Network error");
+    useSWR.mockReturnValue({ data: undefined, error, mutate: mockMutate });
+
+    const { result } = renderHook(() => useAgentConversations());
+    expect(result.current.error).toBe(error);
+    expect(result.current.loading).toBe(false);
+  });
+
+  it("exposes refresh as the mutate function", () => {
+    useSWR.mockReturnValue({
+      data: { data: [] },
+      error: null,
+      mutate: mockMutate,
+    });
+
+    const { result } = renderHook(() => useAgentConversations());
+    expect(result.current.refresh).toBe(mockMutate);
+  });
+});

package/src/hooks/useAgentConversations.js

@@ -0,0 +1,15 @@
+import useSWR from "swr";
+import { apiJson } from "@truedat/core/services/api";
+import { API_AGENT_LAYER_CONVERSATIONS } from "../api";
+
+const useAgentConversations = () => {
+  const { data, error, mutate } = useSWR(API_AGENT_LAYER_CONVERSATIONS, apiJson);
+  return {
+    conversations: data?.data?.data ?? data?.data ?? [],
+    loading: !error && !data,
+    error,
+    refresh: mutate,
+  };
+};
+
+export default useAgentConversations;