@docyrus/ui-pro-ai-assistant 0.2.4 → 0.2.6

package/README.md

@@ -12,6 +12,7 @@ A full-featured, drop-in AI assistant chat UI for React. Ships with multi-turn c
 - **AI memories** — Persistent memory management across sessions.
 - **Voice input** — Browser-native speech-to-text.
 - **File uploads** — Attach files to messages with configurable format restrictions.
+- **Agent trigger widget** — Standalone agent carousel with prompt input, per-agent capabilities, model/reasoning selection, and suggestion chips. Decoupled from the chat UI — wire it to any destination.
 - **Chromeless mode** — Optionally hide the header and/or border for seamless embedding.
 - **i18n** — English, German, Spanish, French, Italian, Portuguese, Greek, Slovenian, Turkish.
 - **Vite plugin** — Optional dev-server middleware for Plate editor AI commands.
@@ -119,7 +120,7 @@ function ModalExample() {
 
 ```ts
 // Components
-import { DocyAssistant } from "@docyrus/ui-pro-ai-assistant";
+import { DocyAssistant, AgentTriggerWidget } from "@docyrus/ui-pro-ai-assistant";
 
 // Provider & config
 import {
@@ -137,6 +138,8 @@ import {
 import type {
   AssistantConfig,
   AssistantUser,
+  AgentTriggerWidgetProps,
+  PromptFeatureFlags,
   Project,
   Work,
   WorkTypes,
@@ -261,6 +264,87 @@ The main chat interface component.
 | `onVoiceStart` | `() => void` | Fires when voice recording starts |
 | `onVoiceEnd` | `() => void` | Fires when voice recording ends |
 
+#### Initial prompt
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `initialPrompt` | `string` | — | When provided, the assistant auto-sends this message on mount. Useful when launching the assistant from an agent trigger widget or deep link |
+
+---
+
+### `<AgentTriggerWidget>`
+
+A standalone agent discovery and prompt input component. Displays agents in a carousel with per-agent capabilities, model selection, reasoning levels, and suggestion chips. Fully decoupled from `DocyAssistant` — the consumer decides what happens on submit.
+
+```tsx
+import { AssistantProvider, AgentTriggerWidget } from "@docyrus/ui-pro-ai-assistant";
+
+<AssistantProvider config={config}>
+  <AgentTriggerWidget
+    agentIds={["agent-id-1", "agent-id-2"]}
+    onSubmit={(agentId, prompt, features, modelId) => {
+      // Open DocyAssistant, navigate to a chat page, call an API, etc.
+    }}
+  />
+</AssistantProvider>
+```
+
+#### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `agentIds` | `string[]` | — | **Required.** Agent IDs to display in the carousel |
+| `className` | `string` | — | CSS class on the root element |
+| `placeholder` | `string` | — | Prompt input placeholder text |
+| `onSubmit` | `(agentId, prompt, features, modelId?) => void` | — | Fires when the user submits a prompt. Receives the selected agent ID, prompt text, feature flags, and optional model ID |
+
+#### `PromptFeatureFlags`
+
+The `features` object passed to `onSubmit`:
+
+```ts
+interface PromptFeatureFlags {
+  webSearch: boolean;
+  thinking: boolean;
+  deepResearch: boolean;
+  documentSearch: boolean;
+  workCanvas: boolean;
+  files: boolean;
+}
+```
+
+#### Combining with DocyAssistant
+
+```tsx
+function MyPage() {
+  const [assistantOpen, setAssistantOpen] = useState(false);
+  const [agentId, setAgentId] = useState<string | null>(null);
+  const [initialPrompt, setInitialPrompt] = useState<string>();
+
+  return (
+    <AssistantProvider config={config}>
+      <AgentTriggerWidget
+        agentIds={agentIds}
+        onSubmit={(id, prompt) => {
+          setAgentId(id);
+          setInitialPrompt(prompt);
+          setAssistantOpen(true);
+        }}
+      />
+      {assistantOpen && agentId && (
+        <DocyAssistant
+          isOpen
+          onClose={() => setAssistantOpen(false)}
+          tenantAiAgentId={agentId}
+          initialPrompt={initialPrompt}
+          renderMode="modal"
+        />
+      )}
+    </AssistantProvider>
+  );
+}
+```
+
 ---
 
 ### `useAssistantConfig()`

package/dist/components/agent-trigger-widget/agent-carousel.d.ts

@@ -0,0 +1,8 @@
+import { type AgentTriggerData } from '../../hooks/use-agents-data';
+export interface AgentCarouselProps {
+    agents: AgentTriggerData[];
+    selectedIndex: number;
+    onSelect: (index: number) => void;
+    onNavigate: (direction: number) => void;
+}
+export declare function AgentCarousel({ agents, selectedIndex, onSelect, onNavigate }: AgentCarouselProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/agent-trigger-widget/agent-trigger-prompt.d.ts

@@ -0,0 +1,18 @@
+import { type AgentCapabilities } from '../../hooks/use-deployment-data';
+import { type Model } from '../../types';
+export interface PromptFeatureFlags {
+    webSearch: boolean;
+    thinking: boolean;
+    deepResearch: boolean;
+    documentSearch: boolean;
+    workCanvas: boolean;
+    files: boolean;
+}
+export interface AgentTriggerPromptProps {
+    capabilities: AgentCapabilities | null;
+    models: Model[];
+    suggestions: string[];
+    placeholder?: string;
+    onSubmit: (prompt: string, features: PromptFeatureFlags, modelId?: string) => void;
+}
+export declare function AgentTriggerPrompt({ capabilities, models, suggestions, placeholder, onSubmit }: AgentTriggerPromptProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/agent-trigger-widget/index.d.ts

@@ -0,0 +1,8 @@
+import { type PromptFeatureFlags } from './agent-trigger-prompt';
+export interface AgentTriggerWidgetProps {
+    agentIds: string[];
+    className?: string;
+    placeholder?: string;
+    onSubmit?: (agentId: string, prompt: string, features: PromptFeatureFlags, modelId?: string) => void;
+}
+export declare function AgentTriggerWidget({ agentIds, className, placeholder, onSubmit }: AgentTriggerWidgetProps): import("react/jsx-runtime").JSX.Element;

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, tenantAiAgentId, onMessageSend, onVoiceStart, onVoiceEnd, className, defaultFullscreen, hideExpand, hideCloseButton, hideAgentSelector, hideBorder, showHeader, agentSelectorUrl, baseAgentSelectorUrl, onAgentChange, ...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, enableNavDropdown, enableVoice, enableMicrophone, tenantAiAgentId, onMessageSend, onVoiceStart, onVoiceEnd, className, defaultFullscreen, hideExpand, hideCloseButton, hideAgentSelector, hideBorder, showHeader, agentSelectorUrl, baseAgentSelectorUrl, onAgentChange, initialPrompt, ...props }: DocyAssistantProps & {
     ref?: RefObject<HTMLDivElement | null>;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export { useAgentsData, type AgentTriggerData, type UseAgentsDataResult } from './use-agents-data';
 export { useAssistantApi } from './use-assistant-api';
 export { useDeploymentData } from './use-deployment-data';
 export { type ProjectState, useProjectState } from './use-project-state';

package/dist/hooks/use-agents-data.d.ts

@@ -0,0 +1,19 @@
+import { type AgentCapabilities } from './use-deployment-data';
+import { type Model } from '../types';
+export interface AgentTriggerData {
+    id: string;
+    name: string;
+    avatar: string | null;
+    welcomeMessage: string | null;
+    description: string | null;
+    capabilities: AgentCapabilities;
+    models: Model[];
+    standardSuggestions: string[];
+}
+export interface UseAgentsDataResult {
+    agents: AgentTriggerData[];
+    isLoading: boolean;
+    error: Error | null;
+    retry: () => void;
+}
+export declare function useAgentsData(agentIds: string[]): UseAgentsDataResult;

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { DocyAssistant } from './docy-assistant';
 export { type AssistantConfig, AssistantProvider, type AssistantUser, useAssistantConfig } from './lib/assistant-config';
 export { AssistantI18nProvider, useAssistantTranslation } from './i18n';
+export { AgentTriggerWidget, type AgentTriggerWidgetProps } from './components/agent-trigger-widget';
+export { type PromptFeatureFlags } from './components/agent-trigger-widget/agent-trigger-prompt';
 export type { Project, Work, WorkTypes } from './types';