@docyrus/ui-pro-ai-assistant 0.7.2 → 0.7.4

package/README.md

@@ -219,8 +219,9 @@ The main chat interface component.
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `enableSidebar` | `boolean` | `true` | Show the session list sidebar |
-| `enableWelcomePage` | `boolean` | `true` | Show a welcome landing page on first open with agent greeting, inline prompt input, and recent sessions. Sidebar and header are hidden in this view. Dismissed on interaction (new chat, session click, or message send) |
-| `defaultFullscreen` | `boolean` | `false` | Start in fullscreen |
+| `enableWelcomePage` | `boolean` | `true` | Show a welcome landing page on first open with agent greeting, inline prompt input, and recent sessions. The header (with agent tabs) stays visible so users can switch agents from the welcome screen; the sidebar is hidden. Dismissed on interaction (new chat, session click, or message send) |
+| `defaultFullscreen` | `boolean` | `false` | Initial uncontrolled fullscreen state |
+| `isFullscreen` | `boolean` | — | Controlled fullscreen state. When provided, the package no longer manages its own fullscreen state — pair with `onFullscreenChange` to fully drive the expand button from the host |
 | `hideExpand` | `boolean` | `false` | Hide the fullscreen toggle |
 | `hideCloseButton` | `boolean` | `false` | Hide the close (X) button in the header |
 | `hideBorder` | `boolean` | `false` | Hide the outer border and shadow of the assistant container |
@@ -249,6 +250,8 @@ The main chat interface component.
 
 The header renders a tab strip. The first tab is pinned to `tenantAiAgentId` and cannot be closed. The `+` button next to it opens a dropdown listing the available base agents (from `agentSelectorUrl`); selecting one opens a new closable tab with its own isolated thread and message history. Open tabs are persisted to `localStorage`.
 
+Switching agents (either selecting an existing tab or adding a new one) resets navigation to the chat home — the previous agent's projects/works pane is dismissed and any selected project / project context is cleared, so the user lands in the new agent's chat view rather than a stale pane.
+
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `agentSelectorUrl` | `string` | `"/ai/agent-deployments/base"` | Endpoint listing base agents shown in the "+" dropdown |
@@ -271,7 +274,7 @@ The header renders a tab strip. The first tab is pinned to `tenantAiAgentId` and
 | `onMessageSend` | `(message: string) => void` | Fires when a message is sent |
 | `onVoiceStart` | `() => void` | Fires when voice recording starts |
 | `onVoiceEnd` | `() => void` | Fires when voice recording ends |
-| `onFullscreenChange` | `(isFullscreen: boolean) => void` | Intercepts the expand button. When provided, replaces the package's built-in fullscreen toggle — the host receives the intended next state and decides what to do (toggle, redirect, etc.). When omitted, the package self-toggles its fullscreen state. |
+| `onFullscreenChange` | `(isFullscreen: boolean) => void` | Intercepts the expand button. When provided, replaces the package's built-in fullscreen toggle — the host receives the intended next state and decides what to do (toggle, redirect, etc.). When omitted, the package self-toggles its fullscreen state. Pair with `isFullscreen` for a fully controlled expand/collapse. |
 | `onShare` | `(info: { dataSourceId: string; recordId: string }) => void` | Custom share handler. When provided, the thread header share button calls this instead of the built-in sharing editor |
 
 #### Initial prompt

package/dist/docy-assistant.d.ts

@@ -1,5 +1,5 @@
 import { type RefObject } from 'react';
 import { type DocyAssistantProps } from './types';
-export declare const DocyAssistant: ({ ref, isOpen, onClose, supportWebSearch, supportThinking, supportFiles, supportDocumentSearch, supportDeepResearch, supportMultiModels, supportWorkCanvas, apiEndpoint, title: titleProp, description: descriptionProp, placeholder: placeholderProp, logo, footerText: footerTextProp, variant, renderMode, enableSidebar, enableVoice, enableMicrophone, enableWelcomePage, tenantAiAgentId, onMessageSend, onVoiceStart, onVoiceEnd, className, defaultFullscreen, hideExpand, hideCloseButton, hideBorder, showHeader, hideHeaderOnWelcome, agentSelectorUrl, onAgentChange, onFullscreenChange, enableSharing, onShare: onShareProp, initialPrompt, initialModelId, initialFeatures, initialFiles, hostEnvironment, appId, appName, appIcon, clientTools, ...props }: DocyAssistantProps & {
+export declare const DocyAssistant: ({ ref, isOpen, onClose, supportWebSearch, supportThinking, supportFiles, supportDocumentSearch, supportDeepResearch, supportMultiModels, supportWorkCanvas, apiEndpoint, title: titleProp, description: descriptionProp, placeholder: placeholderProp, logo, footerText: footerTextProp, variant, renderMode, enableSidebar, enableVoice, enableMicrophone, enableWelcomePage, tenantAiAgentId, onMessageSend, onVoiceStart, onVoiceEnd, className, defaultFullscreen, isFullscreen: isFullscreenProp, hideExpand, hideCloseButton, hideBorder, showHeader, agentSelectorUrl, onAgentChange, onFullscreenChange, enableSharing, onShare: onShareProp, initialPrompt, initialModelId, initialFeatures, initialFiles, hostEnvironment, appId, appName, appIcon, clientTools, ...props }: DocyAssistantProps & {
     ref?: RefObject<HTMLDivElement | null>;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/hooks/use-session-state.d.ts

@@ -14,6 +14,7 @@ export declare function useSessionState(): {
     state: SessionState;
     actions: {
         setSessions: (sessions: AssistantSession[]) => void;
+        appendSessions: (sessions: AssistantSession[]) => void;
         selectSessionId: (id: string | null) => void;
         selectSession: (session: AssistantSession | null) => void;
         startEditing: () => void;

package/dist/index.js

@@ -3108,13 +3108,19 @@ function processMessagesData(rawData) {
 }
 
 // src/lib/assistant-api-actions.ts
-async function fetchAgentThreads(apiClient, tenantAiAgentId, onSuccess, userId, deploymentId) {
+async function fetchAgentThreads(apiClient, tenantAiAgentId, onSuccess, userId, deploymentId, limit, offset3) {
   try {
     const apiParams = {
       columns: "id,subject,created_on,last_modified_on,body_text,tenant_ai_agent_id,created_by",
       expand: "created_by",
       orderBy: JSON.stringify({ field: "created_on", direction: "desc" })
     };
+    if (typeof limit === "number" && limit > 0) {
+      apiParams.limit = limit;
+    }
+    if (typeof offset3 === "number" && offset3 > 0) {
+      apiParams.offset = offset3;
+    }
     const agentRule = deploymentId ? { field: "tenant_ai_agent_deployment_id", operator: "=", value: deploymentId } : { field: "tenant_ai_agent_id", operator: "=", value: tenantAiAgentId };
     const rules = [agentRule, { field: "archived", operator: "=", value: "false" }];
     if (userId) {
@@ -4751,6 +4757,12 @@ function sessionReducer(state, action) {
   switch (action.type) {
     case "SET_SESSIONS":
       return { ...state, sessions: action.payload };
+    case "APPEND_SESSIONS": {
+      const existing = new Set(state.sessions.map((s) => s.id));
+      const fresh = action.payload.filter((s) => !existing.has(s.id));
+      if (fresh.length === 0) return state;
+      return { ...state, sessions: [...state.sessions, ...fresh] };
+    }
     case "SELECT_SESSION_ID":
       return { ...state, selectedSessionId: action.payload };
     case "SELECT_SESSION":
@@ -4799,6 +4811,9 @@ function useSessionState() {
   const setSessions = useCallback((sessions) => {
     dispatch({ type: "SET_SESSIONS", payload: sessions });
   }, []);
+  const appendSessions = useCallback((sessions) => {
+    dispatch({ type: "APPEND_SESSIONS", payload: sessions });
+  }, []);
   const selectSessionId = useCallback((id) => {
     dispatch({ type: "SELECT_SESSION_ID", payload: id });
   }, []);
@@ -4841,6 +4856,7 @@ function useSessionState() {
   const actions = useMemo(
     () => ({
       setSessions,
+      appendSessions,
       selectSessionId,
       selectSession,
       startEditing,
@@ -4857,6 +4873,7 @@ function useSessionState() {
     }),
     [
       setSessions,
+      appendSessions,
       selectSessionId,
       selectSession,
       startEditing,
@@ -19433,6 +19450,7 @@ var MessageItem = memo(({
     ), children: [
       /* @__PURE__ */ jsx(MessageContent, { className: cn(
         "group-[.is-user]:p-2 group-[.is-user]:mt-0.5",
+        "group-[.is-user]:text-foreground",
         isEditing && isUserMessage && "flex-1 w-full max-w-full"
       ), children: renderMessageContent() }),
       isAssistantMessage && !isStreaming && textContent && /* @__PURE__ */ jsx(MessageActions, { className: "mt-1 opacity-0 group-hover:opacity-100 transition-opacity", children: /* @__PURE__ */ jsx(CopyButton, { text: textContent }) }),
@@ -34575,7 +34593,6 @@ var AssistantView = ({ ref, ...props }) => {
     hideCloseButton,
     hideBorder,
     showHeader = true,
-    hideHeaderOnWelcome = true,
     t,
     ...commonProps
   } = props;
@@ -34592,7 +34609,7 @@ var AssistantView = ({ ref, ...props }) => {
       "data-render-mode": "inline",
       ref,
       children: [
-        showHeader && (!hideHeaderOnWelcome || !(commonProps.showWelcome && commonProps.messages.length === 0)) && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between h-12 px-3 border-b shrink-0 bg-background gap-2", children: [
+        showHeader && /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between h-12 px-3 border-b shrink-0 bg-background gap-2", children: [
           /* @__PURE__ */ jsx("div", { className: "flex items-center gap-1 min-w-0 flex-1", children: renderHeaderTabs ? renderHeaderTabs({ isFullscreen }) : null }),
           /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-1 shrink-0", children: [
             onExpand && /* @__PURE__ */ jsx(
@@ -35696,12 +35713,19 @@ var SidebarContent = ({
   onShowMoreProjects,
   onNewProject,
   onToggleSidebar,
+  onLoadMoreSessions,
+  hasMoreSessions,
   supportWorkCanvas = true,
   t
 }) => {
   const [storedListType, setActiveListType] = useState("sessions");
   const activeListType = !supportWorkCanvas && storedListType === "works" ? "sessions" : storedListType;
   const [openMenuId, setOpenMenuId] = useState(null);
+  const handleSessionsScroll = useCallback((e) => {
+    if (activeListType !== "sessions" || !hasMoreSessions || !onLoadMoreSessions) return;
+    const el = e.currentTarget;
+    if (el.scrollHeight - el.scrollTop - el.clientHeight < 80) onLoadMoreSessions();
+  }, [activeListType, hasMoreSessions, onLoadMoreSessions]);
   const navItems = [{ id: 1, label: t("tabs.sessions"), icon: MessageSquare }, ...supportWorkCanvas ? [{ id: 3, label: t("tabs.works"), icon: NotebookText }] : []];
   return /* @__PURE__ */ jsxs("div", { className: "flex flex-col flex-1 min-h-0", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-px", children: [
@@ -35823,6 +35847,7 @@ var SidebarContent = ({
           "div",
           {
             className: "flex-1 overflow-y-auto",
+            onScroll: handleSessionsScroll,
             style: {
               scrollbarWidth: "thin",
               scrollbarColor: "var(--muted-foreground) transparent"
@@ -36103,6 +36128,7 @@ function dataUrlToFile(dataUrl, filename) {
   }
   return new File([u8arr], filename, { type: mime });
 }
+var THREADS_PAGE_SIZE = 20;
 var DocyAssistant = ({
   ref,
   isOpen = true,
@@ -36132,11 +36158,11 @@ var DocyAssistant = ({
   onVoiceEnd,
   className,
   defaultFullscreen = false,
+  isFullscreen: isFullscreenProp,
   hideExpand = false,
   hideCloseButton = false,
   hideBorder = false,
   showHeader = true,
-  hideHeaderOnWelcome = true,
   agentSelectorUrl = "/ai/agent-deployments/base",
   onAgentChange,
   onFullscreenChange,
@@ -36211,7 +36237,9 @@ var DocyAssistant = ({
   const [showWelcome, setShowWelcome] = useState(() => enableWelcomePage && tabs.length <= 1);
   const currentUserId = configUser.id;
   const [projectSearchQuery, setProjectSearchQuery] = useState("");
-  const [isInlineFullscreen, setIsInlineFullscreen] = useState(defaultFullscreen);
+  const [internalInlineFullscreen, setInternalInlineFullscreen] = useState(defaultFullscreen);
+  const isInlineFullscreen = isFullscreenProp ?? internalInlineFullscreen;
+  const setIsInlineFullscreen = setInternalInlineFullscreen;
   const [sharingEditorOpen, setSharingEditorOpen] = useState(false);
   const [appContext, setAppContext] = useState(
     appId ? { id: appId, name: appName, icon: appIcon } : null
@@ -36417,8 +36445,35 @@ var DocyAssistant = ({
       return changed ? next : prev;
     });
   }, [agentDetails, agentDetailsForId]);
-  const fetchThreads = useCallback(async () => {
-    await fetchAgentThreads(apiClient, activeAgentId, sessionActions.setSessions, currentUserId, deploymentId);
+  const [hasMoreThreads, setHasMoreThreads] = useState(true);
+  const isLoadingMoreThreadsRef = useRef(false);
+  const sessionsRef = useRef(sessionState.sessions);
+  useEffect(() => {
+    sessionsRef.current = sessionState.sessions;
+  }, [sessionState.sessions]);
+  const fetchThreads = useCallback(async (mode = "initial") => {
+    if (mode === "more") {
+      if (isLoadingMoreThreadsRef.current) return;
+      isLoadingMoreThreadsRef.current = true;
+    }
+    const offset3 = mode === "more" ? sessionsRef.current.length : 0;
+    await fetchAgentThreads(
+      apiClient,
+      activeAgentId,
+      (threads) => {
+        if (mode === "initial") {
+          sessionActions.setSessions(threads);
+        } else {
+          sessionActions.appendSessions(threads);
+        }
+        setHasMoreThreads(threads.length === THREADS_PAGE_SIZE);
+      },
+      currentUserId,
+      deploymentId,
+      THREADS_PAGE_SIZE,
+      offset3
+    );
+    if (mode === "more") isLoadingMoreThreadsRef.current = false;
   }, [
     apiClient,
     activeAgentId,
@@ -36426,6 +36481,10 @@ var DocyAssistant = ({
     currentUserId,
     deploymentId
   ]);
+  const loadMoreThreads = useCallback(() => {
+    if (!hasMoreThreads) return;
+    void fetchThreads("more");
+  }, [fetchThreads, hasMoreThreads]);
   const fetchProjectThreads2 = useCallback(async (projectId) => {
     await fetchProjectThreads(apiClient, projectId, projectActions.setProjectThreads);
   }, [apiClient, projectActions]);
@@ -36463,7 +36522,8 @@ var DocyAssistant = ({
   ]);
   useEffect(() => {
     if (isOpen && enableSidebar) {
-      fetchThreads();
+      setHasMoreThreads(true);
+      void fetchThreads("initial");
     }
   }, [isOpen, enableSidebar, fetchThreads]);
   useEffect(() => {
@@ -36528,6 +36588,12 @@ var DocyAssistant = ({
   };
   const tabSnapshotsRef = useRef(/* @__PURE__ */ new Map());
   const previousTabIdRef = useRef(activeTabId);
+  const resetNavigationForAgentSwitch = useCallback(() => {
+    uiActions.setActiveTab(0);
+    projectActions.setView("list");
+    projectActions.selectProject(null);
+    projectActions.setContext(null);
+  }, [uiActions, projectActions]);
   const handleTabSelect = useCallback((nextTabId) => {
     if (nextTabId === activeTabId) return;
     tabSnapshotsRef.current.set(activeTabId, {
@@ -36535,7 +36601,8 @@ var DocyAssistant = ({
       messages
     });
     setActiveTabId(nextTabId);
-  }, [activeTabId, messages]);
+    resetNavigationForAgentSwitch();
+  }, [activeTabId, messages, resetNavigationForAgentSwitch]);
   const handleAddTab = useCallback((agent) => {
     const existing = tabs.find((t2) => t2.agentId === agent.id && t2.agentType === agent.type);
     if (existing) {
@@ -36556,13 +36623,15 @@ var DocyAssistant = ({
     });
     setTabs((prev) => [...prev, newTab]);
     setActiveTabId(newTab.id);
+    resetNavigationForAgentSwitch();
     onAgentChange?.(agent.id, agent.type);
   }, [
     tabs,
     activeTabId,
     messages,
     handleTabSelect,
-    onAgentChange
+    onAgentChange,
+    resetNavigationForAgentSwitch
   ]);
   const pendingForwardRef = useRef(null);
   const handleForwardToAgent = useCallback(({ agentId: targetAgentId, prompt }) => {
@@ -36910,6 +36979,8 @@ var DocyAssistant = ({
       },
       onToggleSidebar: isFloating && !uiState.isExpanded ? () => uiActions.setSidebarOpen(false) : void 0,
       supportWorkCanvas: effectiveSupportWorkCanvas,
+      onLoadMoreSessions: loadMoreThreads,
+      hasMoreSessions: hasMoreThreads,
       t
     }
   );
@@ -37302,7 +37373,6 @@ var DocyAssistant = ({
       hideCloseButton,
       hideBorder,
       showHeader,
-      hideHeaderOnWelcome,
       renderHeaderTabs: ({ isFullscreen: fs }) => /* @__PURE__ */ jsx(
         AgentTabs,
         {