@docyrus/ui-pro-ai-assistant 0.6.8 → 0.6.9

package/README.md

@@ -78,7 +78,6 @@ function App() {
         tenantAiAgentId="your-agent-id"
         renderMode="inline"
         enableSidebar
-        enableNavDropdown
         className="h-full w-full"
       />
     </AssistantProvider>
@@ -220,14 +219,12 @@ The main chat interface component.
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
 | `enableSidebar` | `boolean` | `true` | Show the session list sidebar |
-| `enableNavDropdown` | `boolean` | `false` | Show navigation dropdown |
 | `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 |
 | `hideExpand` | `boolean` | `false` | Hide the fullscreen toggle |
 | `hideCloseButton` | `boolean` | `false` | Hide the close (X) button in the header |
-| `hideAgentSelector` | `boolean` | `false` | Hide the agent selector dropdown; shows agent name as static text instead |
 | `hideBorder` | `boolean` | `false` | Hide the outer border and shadow of the assistant container |
-| `showHeader` | `boolean` | `true` | Show the header bar; when false the agent selector moves to the top of the sidebar |
+| `showHeader` | `boolean` | `true` | Show the header bar with the agent tabs |
 | `maxMessages` | `number` | — | Max messages to keep in context |
 
 #### Features
@@ -248,13 +245,14 @@ The main chat interface component.
 
 > **Note:** Feature props serve as defaults. When the agent deployment is loaded, the API response capabilities (`supportWebSearch`, `documentSearch`, `supportDeepResearch`, `supportThinking`, `featureWorks`, `supportFiles`, `supportMultipleModels`, `promptOptimizationChoice`) take precedence over prop values.
 
-#### Agent selection
+#### Agent tabs
+
+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`.
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `agentSelectorUrl` | `string` | `"/ai/agent-deployments"` | Deployment selector endpoint |
-| `baseAgentSelectorUrl` | `string` | `"/ai/agent-deployments/base"` | Base agent selector endpoint |
-| `onAgentChange` | `(agentId: string, agentType: "base" \| "deployment") => void` | — | Fires when the active agent changes |
+| `agentSelectorUrl` | `string` | `"/ai/agent-deployments/base"` | Endpoint listing base agents shown in the "+" dropdown |
+| `onAgentChange` | `(agentId: string, agentType: "base" \| "deployment") => void` | — | Fires when the user opens a new agent tab |
 
 #### API
 
@@ -273,6 +271,7 @@ The main chat interface component.
 | `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` | Fires when the assistant enters or exits fullscreen (true = entered) |
 | `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/components/agent-tabs.d.ts

@@ -0,0 +1,33 @@
+export interface AgentTabItem {
+    /** Unique tab id (stable across renders). */
+    id: string;
+    /** Agent (base) id or deployment id used at the API level. */
+    agentId: string;
+    /** Set when the tab represents a deployed agent. */
+    deploymentId?: string;
+    /** 'base' for tenantAiAgentId-style agents, 'deployment' otherwise. */
+    agentType: 'base' | 'deployment';
+    name?: string;
+    avatar?: string;
+    /** The first tab is pinned and cannot be closed. */
+    pinned?: boolean;
+}
+interface AgentTabsProps {
+    tabs: AgentTabItem[];
+    activeTabId: string;
+    onTabSelect: (tabId: string) => void;
+    onTabClose: (tabId: string) => void;
+    onAddTab: (agent: {
+        id: string;
+        type: 'base' | 'deployment';
+        name?: string;
+        avatar?: string;
+    }) => void;
+    /** URL listing deployed agents shown in the "+" dropdown. */
+    agentSelectorUrl?: string;
+    isFullscreen?: boolean;
+    fallbackLogo?: string;
+    fallbackTitle?: string;
+}
+export declare const AgentTabs: ({ tabs, activeTabId, onTabSelect, onTabClose, onAddTab, agentSelectorUrl, isFullscreen, fallbackLogo, fallbackTitle }: AgentTabsProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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, enableNavDropdown, enableVoice, enableMicrophone, enableWelcomePage, tenantAiAgentId, onMessageSend, onVoiceStart, onVoiceEnd, className, defaultFullscreen, hideExpand, hideCloseButton, hideAgentSelector, hideBorder, showHeader, hideHeaderOnWelcome, agentSelectorUrl, baseAgentSelectorUrl, onAgentChange, 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, hideExpand, hideCloseButton, hideBorder, showHeader, hideHeaderOnWelcome, 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-assistant-api.d.ts

@@ -12,6 +12,13 @@ interface UseAssistantApiReturn {
         name?: string;
         welcomeMessage?: string;
     } | null;
+    /**
+     * Agent identifier (deploymentId || tenantAiAgentId) that `agentDetails`,
+     * `subagents`, and `agentTools` correspond to. Consumers can compare this
+     * against the active agent id to avoid rendering stale data while a refetch
+     * is in flight after the active agent changes.
+     */
+    agentDetailsForId: string | null;
     isLoadingAgentDetails: boolean;
     /**
      * Combined list of subagents reachable from this orchestrator (direct