@docyrus/ui-pro-ai-assistant 0.8.0 → 0.8.1

package/README.md

@@ -10,6 +10,7 @@ A full-featured, drop-in AI assistant chat UI for React. Ships with multi-turn c
 - **Multi-model & multi-agent** — Let users switch between AI models and agent deployments on the fly. Agent avatars display in the header and message list.
 - **Deep research** — Extended research mode with live progress streaming.
 - **AI memories** — Persistent memory management across sessions.
+- **Agent consent gate** — Agents requiring consent show a non-closable terms dialog and block the prompt input until a `super_admin` approves.
 - **Edit & resend prompts** — Hover any user message to edit it; subsequent assistant replies are archived server-side and the conversation regenerates from that point.
 - **Voice input** — Browser-native speech-to-text.
 - **File uploads** — Attach files to messages with configurable format restrictions.
@@ -221,11 +222,14 @@ interface AssistantUser {
   firstname?: string;
   lastname?: string;
   photo?: string;   // optional — avatar in chat messages
+  roles?: string[]; // optional — tenant roles; `'super_admin'` may approve an agent's consent terms
 }
 ```
 
 > **Note:** `user.id` must be the authenticated user's UUID as stored in Docyrus. Without it, the session list will not be filtered and all tenant users' threads will be visible.
 
+> **Agent consent:** When an agent requires consent (`agent.consent` is `false`/`null`), the assistant shows a non-closable "Terms & Agreement" gate and hides the prompt input until the terms are accepted. Only users whose `roles` include `'super_admin'` can approve; everyone else sees the terms with the Approve button disabled.
+
 ---
 
 ### `<DocyAssistant>`

package/dist/components/agent-consent-dialog.d.ts

@@ -0,0 +1,22 @@
+export interface PendingConsent {
+    agentId: string;
+    deploymentId?: string;
+}
+interface AgentConsentDialogProps {
+    /** Pending consent for the active agent, or `null` when none is required. */
+    pending: PendingConsent | null;
+    /** Called after the terms are approved (consent satisfied). */
+    onApproved: () => void;
+    /** Called when the user declines — should close the assistant. */
+    onDeclined: () => void;
+    t: (key: string) => string;
+}
+/**
+ * Gates the assistant behind an agent's "Terms & Agreement" consent.
+ *
+ * Shown (non-closable) the first time an agent is used (`agent.consent` is
+ * falsy). Only `super_admin` users can approve; everyone else sees the terms
+ * but the Approve button stays disabled — mirroring the Vue `KvAssistantView`.
+ */
+export declare function AgentConsentDialog({ pending, onApproved, onDeclined, t }: AgentConsentDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/hooks/use-assistant-api.d.ts

@@ -33,6 +33,20 @@ interface UseAssistantApiReturn {
      * an in-flight tool call (e.g. switch to AdaptiveCard rendering).
      */
     agentTools: Array<Record<string, any>>;
+    /**
+     * Set when the active agent requires consent that has not been given yet
+     * (`agent.consent` is falsy). `null` once consent is satisfied. Drives the
+     * "Terms & Agreement" gate. Mirrors the Vue `KvAssistantView` consent flow.
+     */
+    consentRequiredFor: {
+        agentId: string;
+        deploymentId?: string;
+    } | null;
+    /** Clears the pending consent (call after approve, or to dismiss the gate). */
+    setConsentRequiredFor: (value: {
+        agentId: string;
+        deploymentId?: string;
+    } | null) => void;
     fetchThreads: () => Promise<AssistantSession[]>;
     fetchProjectThreads: (projectId: string) => Promise<AssistantSession[]>;
     loadThreadMessages: (threadId: string) => Promise<any[]>;