@sinequa/assistant 3.7.0 → 3.7.2

package/chat/chat-message/chat-message.component.d.ts

@@ -1,7 +1,7 @@
 import { EventEmitter, OnChanges, SimpleChanges, ChangeDetectorRef, AfterViewInit, ElementRef } from "@angular/core";
 import { PrincipalWebService } from "@sinequa/core/web-services";
 import { SearchService } from "@sinequa/components/search";
-import { ChatContextAttachment, ChatMessage, ChatStarter, SuggestedAction } from "../types";
+import { ChatContextAttachment, ChatMessage, SuggestedAction } from "../types";
 import { Processor } from "unified";
 import { Node } from "unist";
 import { UIService } from "@sinequa/components/utils";
@@ -17,7 +17,6 @@ export declare class ChatMessageComponent implements OnChanges, AfterViewInit {
     message: ChatMessage;
     conversation: ChatMessage[];
     suggestedActions: SuggestedAction[] | undefined;
-    chatStarters: ChatStarter[] | undefined;
     assistantMessageIcon: string;
     userMessageIcon: string;
     connectionErrorMessageIcon: string;
@@ -38,12 +37,11 @@ export declare class ChatMessageComponent implements OnChanges, AfterViewInit {
         partId?: number | undefined;
     }>;
     suggestAction: EventEmitter<SuggestedAction>;
-    chatStarterClicked: EventEmitter<ChatStarter>;
     edit: EventEmitter<ChatMessage>;
     copy: EventEmitter<ChatMessage>;
     regenerate: EventEmitter<ChatMessage>;
-    like: EventEmitter<ChatMessage>;
-    dislike: EventEmitter<ChatMessage>;
+    like: EventEmitter<any>;
+    dislike: EventEmitter<any>;
     debug: EventEmitter<ChatMessage>;
     processor: Processor;
     references: string[];
@@ -51,8 +49,6 @@ export declare class ChatMessageComponent implements OnChanges, AfterViewInit {
     showReferences: boolean;
     collapseProgress: boolean;
     iconSize: number;
-    liked: boolean;
-    disliked: boolean;
     hiddenTooltip: boolean;
     constructor(searchService: SearchService, ui: UIService, principalService: PrincipalWebService, cdr: ChangeDetectorRef, el: ElementRef);
     ngOnChanges(changes: SimpleChanges): void;
@@ -81,5 +77,5 @@ export declare class ChatMessageComponent implements OnChanges, AfterViewInit {
     openOriginalAttachment(attachment: ChatContextAttachment, partId?: number): void;
     hideTooltip(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatMessageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChatMessageComponent, "sq-chat-message", never, { "message": "message"; "conversation": "conversation"; "suggestedActions": "suggestedActions"; "chatStarters": "chatStarters"; "assistantMessageIcon": "assistantMessageIcon"; "userMessageIcon": "userMessageIcon"; "connectionErrorMessageIcon": "connectionErrorMessageIcon"; "searchWarningMessageIcon": "searchWarningMessageIcon"; "streaming": "streaming"; "canEdit": "canEdit"; "canRegenerate": "canRegenerate"; "canCopy": "canCopy"; "canDebug": "canDebug"; "canLike": "canLike"; "canDislike": "canDislike"; }, { "openDocument": "openDocument"; "openPreview": "openPreview"; "suggestAction": "suggestAction"; "chatStarterClicked": "chatStarterClicked"; "edit": "edit"; "copy": "copy"; "regenerate": "regenerate"; "like": "like"; "dislike": "dislike"; "debug": "debug"; }, never, never, true>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatMessageComponent, "sq-chat-message", never, { "message": "message"; "conversation": "conversation"; "suggestedActions": "suggestedActions"; "assistantMessageIcon": "assistantMessageIcon"; "userMessageIcon": "userMessageIcon"; "connectionErrorMessageIcon": "connectionErrorMessageIcon"; "searchWarningMessageIcon": "searchWarningMessageIcon"; "streaming": "streaming"; "canEdit": "canEdit"; "canRegenerate": "canRegenerate"; "canCopy": "canCopy"; "canDebug": "canDebug"; "canLike": "canLike"; "canDislike": "canDislike"; }, { "openDocument": "openDocument"; "openPreview": "openPreview"; "suggestAction": "suggestAction"; "edit": "edit"; "copy": "copy"; "regenerate": "regenerate"; "like": "like"; "dislike": "dislike"; "debug": "debug"; }, never, never, true>;
 }

package/chat/chat.component.d.ts

@@ -6,12 +6,13 @@ import { AppService, Query } from "@sinequa/core/app-utils";
 import { PrincipalWebService } from "@sinequa/core/web-services";
 import { BehaviorSubject } from "rxjs";
 import { ChatService } from "./chat.service";
-import { ChatContextAttachment, ChatConfig, ChatMessage, GllmModelDescription, MessageHandler, RawMessage, SuggestedAction, InitChat, DebugMessage, ChatStarter } from "./types";
+import { ChatContextAttachment, ChatConfig, ChatMessage, GllmModelDescription, MessageHandler, RawMessage, SuggestedAction, InitChat, DebugMessage } from "./types";
 import { InstanceManagerService } from "./instance-manager.service";
 import { WebSocketChatService } from "./websocket-chat.service";
 import { LoginService } from "@sinequa/core/login";
 import { RestChatService } from "./rest-chat.service";
 import { HubConnection } from "@microsoft/signalr";
+import { NotificationsService } from "@sinequa/core/notification";
 import * as i0 from "@angular/core";
 export declare class ChatComponent extends AbstractFacet implements OnInit, OnChanges, OnDestroy {
     loginService: LoginService;
@@ -928,6 +929,7 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
     principalService: PrincipalWebService;
     cdr: ChangeDetectorRef;
     appService: AppService;
+    notificationsService: NotificationsService;
     /** Define the key based on it, the chat service instance will be stored */
     instanceId: string;
     /** Define the query to use to fetch answers */
@@ -1075,10 +1077,10 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
     openPreview: EventEmitter<ChatContextAttachment>;
     /** Event emitter triggered when the user clicks on a suggested action */
     suggestAction: EventEmitter<SuggestedAction>;
-    /** Event emitter triggered when the user clicks on a chat starter */
-    chatStarter: EventEmitter<ChatStarter>;
+    /** ViewChild decorators to access the template elements */
     messageList?: ElementRef<HTMLUListElement>;
     questionInput?: ElementRef<HTMLTextAreaElement>;
+    /** ContentChild decorators allowing the override of the default templates from the parent component */
     loadingTpl?: TemplateRef<any>;
     reportTpl?: TemplateRef<any>;
     tokenConsumptionTpl?: TemplateRef<any>;
@@ -1121,24 +1123,68 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
     get isAdmin(): boolean;
-    get visibleMessagesCount(): number;
     /**
      * Instantiate the chat service based on the provided @input protocol
      * This chat service instance will then be stored in the instanceManagerService with provided @input instanceId as a key
      */
     instantiateChatService(): void;
     get actions(): Action[];
+    /**
+     * Handles the changes in the chat component.
+     * If the chat service is a WebSocketChatService, it handles the override of the message handlers if they exist.
+     * Initializes the chat with the provided chat messages if they exist, otherwise loads the default chat.
+     * If the chat is initialized, the initialization event is "Query", the query changes, and the queryChangeShouldTriggerReload function is provided,
+     * then the chat should be reloaded if the function returns true. Otherwise, the chat should be reloaded by default.
+     * It takes into account the ongoing streaming process and the ongoing stopping process to trigger that conditionally define the logic
+     * of the reload :
+     * - If the chat is streaming, then stop the generation and wait for the fetch to complete before reloading the chat.
+     * - If the chat is stopping the generation, then wait for the fetch to complete before reloading the chat.
+     */
     private _handleChanges;
+    /**
+     * Triggers a reload after the query change.
+     * This method performs the necessary operations to reload the chat after a query change.
+     * It sets the system and user messages, resets the savedChatId, generates a new chatId,
+     * generates a new chat audit event, and handles the query mode.
+     */
     private _triggerReloadAfterQueryChange;
+    /**
+     * Adds a scroll listener to the message list element.
+     * The listener is triggered when any of the following events occur:
+     * - Loading state changes
+     * - Messages change
+     * - Streaming state changes
+     * - Scroll event occurs on the message list element
+     *
+     * When the listener is triggered, it updates the `isAtBottom` property.
+     */
     private _addScrollListener;
+    /**
+     * Get the model description based on the defaultValues service_id and model_id
+     */
     updateModelDescription(): void;
+    /**
+     * Submits a question from the user.
+     * If the user is editing a previous message, removes all subsequent messages from the chat history.
+     * Triggers the fetch of the answer for the submitted question by calling _fetchAnswer().
+     * Clears the input value in the UI.
+     * ⚠️ If the chat is streaming or stopping the generation, the operation is not allowed.
+     */
     submitQuestion(): void;
+    /**
+     * Triggers the fetch of the answer for the given question and updates the conversation.
+     * Generates an audit event for the user input.
+     *
+     * @param question - The question asked by the user.
+     * @param conversation - The current conversation messages.
+     */
     private _fetchAnswer;
     /**
      * Depending on the connection's state :
      *  - If connected => given a list of messages, the chat endpoint is invoked for a continuation and updates the list of messages accordingly.
      *  - If any other state => a connection error message is displayed in the chat.
-     * @param messages
+     * ⚠️ If the assistant is streaming or stopping the generation, the operation is not allowed.
+     * @param messages The list of messages to invoke the chat endpoint with
      */
     fetch(messages: ChatMessage[]): void;
     /**
@@ -1159,22 +1205,51 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * @param messages
      */
     updateData(messages: ChatMessage[]): void;
+    /**
+     * @returns true if the chat discussion is scrolled down to the bottom, false otherwise
+     */
     private _toggleScrollButtonVisibility;
+    /**
+     * Scroll down to the bottom of the chat discussion
+     */
     scrollDown(): void;
     /**
-     * Start a new chat with the defaultValues settings
-     * The savedChatId in the chat service will be reset, so that the upcoming saved chat operations will be performed on the fresh new chat
-     * If the savedChat feature is enabled, the list of saved chats will be refreshed
+     * Start a new chat with the defaultValues settings.
+     * The savedChatId in the chat service will be reset, so that the upcoming saved chat operations will be performed on the fresh new chat.
+     * If the savedChat feature is enabled, the list of saved chats will be refreshed.
+     * ⚠️ If the assistant is streaming or stopping the generation, the operation is not allowed.
      */
     newChat(): void;
+    /**
+     * Attaches the specified document IDs to the assistant.
+     * If no document IDs are provided, the operation is not allowed.
+     * If the action for attaching a document is not defined at the application customization level, an error is logged.
+     * ⚠️ If the assistant is streaming or stopping the generation, the operation is not allowed.
+     * @param ids - An array of document IDs to attach.
+     */
+    attachToChat(ids: string[]): void;
     /**
      * Start the default chat with the defaultValues settings
      * If the chat is meant to be initialized with event === "Query", the corresponding user query message will be added to the chat history
      */
     loadDefaultChat(): void;
     /**
+     * Handles the prompt mode of the chat component.
+     * If `sendUserPrompt` is true, it opens the chat with both system and user messages,
+     * and generates audit events for both messages.
+     * If `sendUserPrompt` is false, it opens the chat with only the system message,
+     * and generates an audit event for the system message.
+     *
+     * @param systemMsg - The system message to be displayed in the chat.
+     * @param userMsg - The user message to be displayed in the chat (optional).
+     */
+    private _handlePromptMode;
+    /**
+     * Handles the query mode by displaying the system message, user message, and user query message.
      * If the provided query text is not empty, then add the user query message to the chat history and invoke the assistant
      * Otherwise, just start a new chat with a warning message inviting the user to perform a full text search to retrieve some results
+     * @param systemMsg - The system message to be displayed.
+     * @param userMsg - The user message to be displayed.
      */
     private _handleQueryMode;
     private _defineMessageAuditDetails;
@@ -1192,14 +1267,27 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * The fetch subscription will be terminated
      */
     resetChat(): void;
+    /**
+     * Fetch and Load the saved chat from the saved chat index.
+     * If the saved chat is found, the chat discussion will be loaded with the provided messages and chatId
+     */
     onLoadChat(): void;
+    /**
+     * Stop the generation of the current assistant's answer.
+     * The fetch subscription will be terminated.
+     */
     stopGeneration(): void;
+    /**
+     * Terminate the fetch process by unsubscribing from the data subscription and updating the loading status to false.
+     * Additionally, focus on the chat input if the focusAfterResponse flag is set to true.
+     */
     terminateFetch(): void;
     /**
      * Copy a previous user message of the chat history to the chat user input.
      * Thus, the user can edit and resubmit the message.
      * Once the edited message is submitted, all subsequent messages starting from @param index will be removed from the history and the UI will be updated accordingly.
      * The assistant will regenerate a new answer based on the updated chat history.
+     * ⚠️ If the assistant is streaming or stopping the generation, the operation is not allowed.
      * @param index The index of the user's message to edit
      */
     editMessage(index: number): void;
@@ -1211,6 +1299,7 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
     /**
      * Starting from the provided index, remove all subsequent messages from the chat history and the UI accordingly.
      * The assistant will regenerate a new answer based on the updated chat history.
+     * ⚠️ If the assistant is streaming or stopping the generation, the operation is not allowed.
      * @param index The index of the assistant's message to regenerate
      */
     regenerateMessage(index: number): void;
@@ -1222,7 +1311,16 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * @param index - The index to be remapped.
      */
     private _remapIndexInChatHistory;
+    /**
+     * Handles the key up event for 'Backspace' and 'Enter' keys.
+     * @param event - The keyboard event.
+     */
     onKeyUp(event: KeyboardEvent): void;
+    /**
+     * Calculates and adjusts the height of the question input element based on its content.
+     * If the Enter key is pressed without the Shift key, it prevents the default behavior.
+     * @param event The keyboard event
+     */
     calculateHeight(event?: KeyboardEvent): void;
     /**
      * Send a "like" event on clicking on the thumb-up icon of an assistant's message
@@ -1237,6 +1335,7 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * @param index The rank of the message to dislike
      */
     onDislike(message: ChatMessage, rank: number): void;
+    private _updateChatHistory;
     /**
      * Report an issue related to the assistant's message.
      */
@@ -1267,11 +1366,6 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * @param index Rank of the message in the chatHistory related to the suggested action.
      */
     suggestActionClick(action: SuggestedAction, index: number): void;
-    /**
-     * Handle the click on a chat starter.
-     * @param starter the chat starter.
-     */
-    chatStarterClick(starter: ChatStarter): void;
     /**
      * It looks for the debug messages available in the current group of "assistant" messages.
      * By design, the debug messages are only available in the first visible message among the group "assistant" messages.
@@ -1292,6 +1386,16 @@ export declare class ChatComponent extends AbstractFacet implements OnInit, OnCh
      * @returns if this messages and the following ones (if any) are the last ones
      */
     isAssistantLastMessages(messages: ChatMessage[], index: number): boolean;
+    /**
+     * Checks if the given message is an empty assistant message.
+     * An empty assistant message is defined as a message with the role 'assistant',
+     * an empty content, and no additional properties such as attachments, progress,
+     * debug information, or suggested actions.
+     *
+     * @param message - The message to check.
+     * @returns `true` if the message is an empty assistant message, `false` otherwise.
+     */
+    isEmptyAssistantMessage(message: ChatMessage | undefined): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<ChatComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ChatComponent, "sq-chat-v3", never, { "instanceId": "instanceId"; "query": "query"; "queryChangeShouldTriggerReload": "queryChangeShouldTriggerReload"; "protocol": "protocol"; "messageHandlers": "messageHandlers"; "automaticScrollToLastResponse": "automaticScrollToLastResponse"; "focusAfterResponse": "focusAfterResponse"; "chat": "chat"; "assistantMessageIcon": "assistantMessageIcon"; "userMessageIcon": "userMessageIcon"; "connectionErrorMessageIcon": "connectionErrorMessageIcon"; "searchWarningMessageIcon": "searchWarningMessageIcon"; }, { "connection": "connection"; "loading$": "loading"; "_config": "config"; "data": "data"; "openDocument": "openDocument"; "openPreview": "openPreview"; "suggestAction": "suggestAction"; "chatStarter": "chatStarter"; }, ["loadingTpl", "reportTpl", "tokenConsumptionTpl", "debugMessagesTpl"], never, true>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChatComponent, "sq-chat-v3", never, { "instanceId": "instanceId"; "query": "query"; "queryChangeShouldTriggerReload": "queryChangeShouldTriggerReload"; "protocol": "protocol"; "messageHandlers": "messageHandlers"; "automaticScrollToLastResponse": "automaticScrollToLastResponse"; "focusAfterResponse": "focusAfterResponse"; "chat": "chat"; "assistantMessageIcon": "assistantMessageIcon"; "userMessageIcon": "userMessageIcon"; "connectionErrorMessageIcon": "connectionErrorMessageIcon"; "searchWarningMessageIcon": "searchWarningMessageIcon"; }, { "connection": "connection"; "loading$": "loading"; "_config": "config"; "data": "data"; "openDocument": "openDocument"; "openPreview": "openPreview"; "suggestAction": "suggestAction"; }, ["loadingTpl", "reportTpl", "tokenConsumptionTpl", "debugMessagesTpl"], never, true>;
 }

package/chat/chat.service.d.ts

@@ -11,14 +11,16 @@ import * as i0 from "@angular/core";
 export declare abstract class ChatService {
     /** Name of the assistant plugin OR websocket endpoint. */
     REQUEST_URL: string;
-    /** Emit true once the initialization of the chat process is done. */
+    /** Emit true once the initialization of the assistant process is done. */
     initProcess$: BehaviorSubject<boolean>;
-    /** Emit true once the initialization of the chat config is done. */
+    /** Emit true once the initialization of the assistant config is done. */
     initConfig$: BehaviorSubject<boolean>;
-    /** Global configuration of the chat. */
-    chatConfig$: BehaviorSubject<ChatConfig | undefined>;
+    /** Emit the global configuration of the assistant. */
+    assistantConfig$: BehaviorSubject<ChatConfig | undefined>;
+    /** Emit true if the user has been overridden, false otherwise. */
+    userOverride$: BehaviorSubject<boolean | undefined>;
     /**
-     * Emit true if the fetch of an assistant's response is ongoing (it includes Streaming status of the chat endpoint AND saving the discussion if save Chat is enabled).
+     * Emit true if the fetch of an assistant's response is ongoing (it includes Streaming status of the assistant endpoint AND saving the discussion if save Chat is enabled).
      * This is used to prevent multiple fetches at the same time.
      * Typically, there is no problem chaining fetches, but when forcing a reload after query changes cases, it can't be allowed because it breaks the whole business logic.
     */
@@ -120,6 +122,10 @@ export declare abstract class ChatService {
         "applied-defaultValues-hash"?: string;
         "skipped-defaultValues-hash"?: string;
     }, notify?: boolean, successCallback?: () => any, errorCallback?: () => any): void;
+    /**
+     * Overrides the logged in user
+     */
+    abstract overrideUser(): void;
     /**
      * Calls the Fetch API to retrieve a new message given all previous messages
      */

package/chat/rest-chat.service.d.ts

@@ -18,6 +18,7 @@ export declare class RestChatService extends ChatService {
      * It can be overridden by the app config
      */
     getRequestsUrl(): void;
+    overrideUser(): void;
     listModels(): Observable<GllmModelDescription[] | undefined>;
     listFunctions(): Observable<GllmFunction[] | undefined>;
     fetch(messages: ChatMessage[], query: Query): Observable<ChatResponse>;

package/chat/styles/assistant.scss

@@ -35,6 +35,7 @@ $ast-input-color: var(--ast-input-color, #B0B0B0);
 $ast-muted-color: var(--ast-muted-color, rgba(33, 37, 41, 0.75));
 $ast-action-buttons-color: var(--ast-action-buttons-color, #212529);
 $ast-action-buttons-hover-color: var(--ast-action-buttons-hover-color, var(--ast-primary-color, #005DA7));
+$ast-report-bg: var(--ast-report-bg, white);
 
 /****************************************************
     classes
@@ -95,4 +96,5 @@ $ast-action-buttons-hover-color: var(--ast-action-buttons-hover-color, var(--ast
     --ast-message-reference-color: black;
     --ast-action-buttons-color: white;
     --ast-action-buttons-hover-color: #6dbee6;
+    --ast-report-bg: #070707;
 }

package/chat/types.d.ts

@@ -29,10 +29,13 @@ export interface ChatMessage extends RawMessage {
         $suggestedAction?: SuggestedAction[];
         $debug?: DebugMessage[];
         forcedWorkflow?: string;
+        forcedWorkflowProperties?: any;
         query?: Query;
         isUserInput?: boolean;
         usageMetrics?: ChatUsageMetrics;
         additionalWorkflowProperties?: any;
+        $liked?: boolean;
+        $disliked?: boolean;
         [key: string]: any;
     };
 }
@@ -217,15 +220,6 @@ declare const uiSettingsSchema: z.ZodObject<{
 }>;
 export interface UiSettings extends z.infer<typeof uiSettingsSchema> {
 }
-declare const chatStarterSchema: z.ZodObject<{
-    text: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    text: string;
-}, {
-    text: string;
-}>;
-export interface ChatStarter extends z.infer<typeof chatStarterSchema> {
-}
 declare const defaultValuesSchema: z.ZodObject<{
     service_id: z.ZodString;
     model_id: z.ZodString;
@@ -274,7 +268,7 @@ declare const defaultValuesSchema: z.ZodObject<{
 }>;
 export interface DefaultValues extends z.infer<typeof defaultValuesSchema> {
 }
-declare const modeSettingsSchema: z.ZodEffects<z.ZodObject<{
+declare const modeSettingsSchema: z.ZodObject<{
     enabledUserInput: z.ZodBoolean;
     displayUserPrompt: z.ZodBoolean;
     sendUserPrompt: z.ZodBoolean;
@@ -282,42 +276,33 @@ declare const modeSettingsSchema: z.ZodEffects<z.ZodObject<{
         event: z.ZodEnum<["Query", "Prompt"]>;
         forcedWorkflow: z.ZodOptional<z.ZodString>;
         displayUserQuery: z.ZodOptional<z.ZodBoolean>;
-        chatStarters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            text: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            text: string;
-        }, {
-            text: string;
-        }>, "many">>;
     }, "strip", z.ZodTypeAny, {
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     }, {
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     }>, {
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     }, {
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     }>;
+    actions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        forcedWorkflow: z.ZodString;
+        forcedWorkflowProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        forcedWorkflow: string;
+        forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+    }, {
+        forcedWorkflow: string;
+        forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
     displayUserPrompt: boolean;
     enabledUserInput: boolean;
@@ -326,34 +311,11 @@ declare const modeSettingsSchema: z.ZodEffects<z.ZodObject<{
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
-    };
-}, {
-    displayUserPrompt: boolean;
-    enabledUserInput: boolean;
-    sendUserPrompt: boolean;
-    initialization: {
-        event: "Query" | "Prompt";
-        forcedWorkflow?: string | undefined;
-        displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
-    };
-}>, {
-    displayUserPrompt: boolean;
-    enabledUserInput: boolean;
-    sendUserPrompt: boolean;
-    initialization: {
-        event: "Query" | "Prompt";
-        forcedWorkflow?: string | undefined;
-        displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     };
+    actions?: globalThis.Record<string, {
+        forcedWorkflow: string;
+        forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+    }> | undefined;
 }, {
     displayUserPrompt: boolean;
     enabledUserInput: boolean;
@@ -362,10 +324,11 @@ declare const modeSettingsSchema: z.ZodEffects<z.ZodObject<{
         event: "Query" | "Prompt";
         forcedWorkflow?: string | undefined;
         displayUserQuery?: boolean | undefined;
-        chatStarters?: {
-            text: string;
-        }[] | undefined;
     };
+    actions?: globalThis.Record<string, {
+        forcedWorkflow: string;
+        forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+    }> | undefined;
 }>;
 export interface ModeSettings extends z.infer<typeof modeSettingsSchema> {
 }
@@ -466,7 +429,7 @@ export declare const chatConfigSchema: z.ZodObject<{
         systemPrompt: string;
         userPrompt: string;
     }>;
-    modeSettings: z.ZodEffects<z.ZodObject<{
+    modeSettings: z.ZodObject<{
         enabledUserInput: z.ZodBoolean;
         displayUserPrompt: z.ZodBoolean;
         sendUserPrompt: z.ZodBoolean;
@@ -474,42 +437,33 @@ export declare const chatConfigSchema: z.ZodObject<{
             event: z.ZodEnum<["Query", "Prompt"]>;
             forcedWorkflow: z.ZodOptional<z.ZodString>;
             displayUserQuery: z.ZodOptional<z.ZodBoolean>;
-            chatStarters: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                text: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                text: string;
-            }, {
-                text: string;
-            }>, "many">>;
         }, "strip", z.ZodTypeAny, {
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         }, {
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         }>, {
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         }, {
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         }>;
+        actions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            forcedWorkflow: z.ZodString;
+            forcedWorkflowProperties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
         displayUserPrompt: boolean;
         enabledUserInput: boolean;
@@ -518,34 +472,11 @@ export declare const chatConfigSchema: z.ZodObject<{
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
-        };
-    }, {
-        displayUserPrompt: boolean;
-        enabledUserInput: boolean;
-        sendUserPrompt: boolean;
-        initialization: {
-            event: "Query" | "Prompt";
-            forcedWorkflow?: string | undefined;
-            displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
-        };
-    }>, {
-        displayUserPrompt: boolean;
-        enabledUserInput: boolean;
-        sendUserPrompt: boolean;
-        initialization: {
-            event: "Query" | "Prompt";
-            forcedWorkflow?: string | undefined;
-            displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         };
+        actions?: globalThis.Record<string, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }> | undefined;
     }, {
         displayUserPrompt: boolean;
         enabledUserInput: boolean;
@@ -554,10 +485,11 @@ export declare const chatConfigSchema: z.ZodObject<{
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         };
+        actions?: globalThis.Record<string, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }> | undefined;
     }>;
     uiSettings: z.ZodObject<{
         display: z.ZodBoolean;
@@ -660,10 +592,11 @@ export declare const chatConfigSchema: z.ZodObject<{
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         };
+        actions?: globalThis.Record<string, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }> | undefined;
     };
     uiSettings: {
         display: boolean;
@@ -723,10 +656,11 @@ export declare const chatConfigSchema: z.ZodObject<{
             event: "Query" | "Prompt";
             forcedWorkflow?: string | undefined;
             displayUserQuery?: boolean | undefined;
-            chatStarters?: {
-                text: string;
-            }[] | undefined;
         };
+        actions?: globalThis.Record<string, {
+            forcedWorkflow: string;
+            forcedWorkflowProperties?: globalThis.Record<string, unknown> | undefined;
+        }> | undefined;
     };
     uiSettings: {
         display: boolean;

package/chat/websocket-chat.service.d.ts

@@ -19,8 +19,9 @@ export declare class WebSocketChatService extends ChatService {
     authenticationService: AuthenticationService;
     constructor();
     /**
-     * Initialize the chat process after the login is complete.
+     * Initialize the assistant process.
      * It includes building and starting a connection, executing parallel requests for models and functions, and handling errors during the process.
+     * ⚠️ This method MUST be called ONLY if the user is loggedIn and once when the assistant is initialized.
      *
      * @returns An Observable<boolean> indicating the success of the initialization process.
      */
@@ -30,6 +31,7 @@ export declare class WebSocketChatService extends ChatService {
      * It can be overridden by the app config
      */
     getRequestsUrl(): void;
+    overrideUser(): void;
     listModels(): Observable<GllmModelDescription[] | undefined>;
     listFunctions(): Observable<GllmFunction[] | undefined>;
     fetch(messages: ChatMessage[], query: Query): Observable<ChatResponse>;