@acorex/modules 21.0.0-next.46 → 21.0.0-next.47

package/fesm2022/{acorex-modules-conversation-acorex-modules-conversation-Dm9D7la2.mjs → acorex-modules-conversation-acorex-modules-conversation-F7nQo1GU.mjs}

@@ -1,15 +1,22 @@
 import { AXConversationModule } from '@acorex/components/conversation';
 import { AXPSessionService, AXPAuthGuard, AXP_PERMISSION_DEFINITION_PROVIDER } from '@acorex/platform/auth';
-import { createAllQueryView, AXPEntityQueryType, AXPSettingsService, AXPCommonSettings, AXPFilterOperatorMiddlewareService, AXPEntityCommandScope, AXPFileStorageService, AXP_MENU_PROVIDER } from '@acorex/platform/common';
-import { AXPDataGenerator, AXPPlatformScope, AXPDeviceService, AXP_MODULE_MANIFEST_PROVIDER } from '@acorex/platform/core';
+import { createAllQueryView, AXPEntityQueryType, AXPSettingsService, AXPCommonSettings, AXPFilterOperatorMiddlewareService, AXPEntityCommandScope, AXPFileStorageService, AXP_MENU_PROVIDER, AXP_SEARCH_PROVIDER, AXP_SEARCH_DEFINITION_PROVIDER } from '@acorex/platform/common';
+import { AXPSystemActionType, AXPDataGenerator, AXPPlatformScope, AXPDeviceService, AXP_MODULE_MANIFEST_PROVIDER } from '@acorex/platform/core';
 import { AXPThemeLayoutBlockComponent, AXPThemeLayoutStartSideComponent, AXPUserAvatarComponent, AXPMarkdownViewerComponent, AXPMarkdownTemplateDirective, AXP_PAGE_COMPONENT_PROVIDER, AXP_TASK_BADGE_PROVIDERS } from '@acorex/platform/layout/components';
-import { AXMEntityCrudServiceImpl, entityMasterCrudActions, entityMasterRecordActions, AXPEntityDefinitionRegistryService, cloneLayoutArrays, ensureLayoutSection, ensureLayoutPropertyView, resolveEntityPluginDetailPageOrder, ensureListActions, actionExists, AXPEntityService, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_DEFINITION_LOADER } from '@acorex/platform/layout/entity';
+import { AXPEntityDefinitionRegistryService, AXMEntityCrudServiceImpl, entityMasterCrudActions, entityMasterRecordActions, cloneLayoutArrays, ensureLayoutSection, ensureLayoutPropertyView, resolveEntityPluginDetailPageOrder, ensureListActions, actionExists, AXPEntityService, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_DEFINITION_LOADER } from '@acorex/platform/layout/entity';
 import { AXPRootLayoutComponent } from '@acorex/platform/themes/default';
 import * as i5 from '@angular/common';
 import { CommonModule, AsyncPipe, DecimalPipe, DatePipe } from '@angular/common';
+import { provideCommandSetups } from '@acorex/platform/runtime';
 import * as i0 from '@angular/core';
-import { Injectable, NgModule, inject, output, signal, viewChild, computed, effect, untracked, ChangeDetectionStrategy, Component, input, afterNextRender, DestroyRef, ElementRef, ViewEncapsulation, Injector, importProvidersFrom } from '@angular/core';
+import { inject, Injectable, NgModule, output, signal, viewChild, computed, effect, untracked, ChangeDetectionStrategy, Component, input, afterNextRender, DestroyRef, ElementRef, ViewEncapsulation, Injector, importProvidersFrom } from '@angular/core';
 import { Router, ActivatedRoute, RouterModule, ROUTES } from '@angular/router';
+import { sortBy } from 'lodash-es';
+import { RootConfig as RootConfig$1, axpAiChatMessagesFromProviderAssistant, axpAiParseDelegatedAgentResultSegmentsFromUnknown, axpAiChatTextMessage, AXPAiAssistChatModelCatalogService, axpAiParseSupervisorAgentToolName, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiDelegatedAgentPromptPreview, axpAiChatToolOrAgentResultBodyJson, axpAiDelegatedAgentOutcomeResponsesPlainText } from '@acorex/modules/ai-management';
+import { AXConversationService, AXNewConversationDialogComponent, AXConversationContainerDirective, AXSidebarComponent, AXInfoBarComponent, AXMessageListComponent, AXComposerComponent, AXUserApi, AXConversationApi, AXMessageApi, AXRealtimeApi, conversationSharedStorage, axConversationIndexedDbStorage, AXImageRendererComponent, AXTextRendererComponent, provideConversation, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_INFO_BAR_INFO_ACTION, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AXComposerService, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_STICKER_RENDERER } from '@acorex/components/conversation2';
+import { AXToastService } from '@acorex/components/toast';
+import * as i3$1 from '@acorex/core/translation';
+import { AXTranslationService, AXTranslationModule } from '@acorex/core/translation';
 import * as i1$3 from '@acorex/platform/layout/widget-core';
 import { AXPWidgetsCatalog, AXPValueWidgetComponent, AXPWidgetGroupEnum, AXPWidgetCoreModule, AXP_WIDGET_DEFINITION_PROVIDER } from '@acorex/platform/layout/widget-core';
 import * as i1$6 from '@acorex/platform/workflow';
@@ -19,19 +26,14 @@ import { AXMUsersEntityService } from '@acorex/modules/security-management';
 import { Subject, map, filter, merge, auditTime } from 'rxjs';
 import * as i2 from '@acorex/components/button';
 import { AXButtonModule, AXButtonComponent } from '@acorex/components/button';
-import { AXConversationService, AXNewConversationDialogComponent, AXConversationContainerDirective, AXSidebarComponent, AXInfoBarComponent, AXMessageListComponent, AXComposerComponent, AXUserApi, AXConversationApi, AXMessageApi, AXRealtimeApi, conversationSharedStorage, axConversationIndexedDbStorage, AXImageRendererComponent, AXTextRendererComponent, provideConversation, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_INFO_BAR_INFO_ACTION, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AXComposerService, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_STICKER_RENDERER } from '@acorex/components/conversation2';
 import { AXDialogService } from '@acorex/components/dialog';
 import * as i1$1 from '@acorex/components/decorators';
 import { AXDecoratorModule } from '@acorex/components/decorators';
-import * as i3$1 from '@acorex/core/translation';
-import { AXTranslationService, AXTranslationModule } from '@acorex/core/translation';
 import { AXPPageLayoutBaseComponent, AXPPageLayoutComponent } from '@acorex/platform/layout/views';
 import { toSignal, takeUntilDestroyed } from '@angular/core/rxjs-interop';
 import * as i3 from '@acorex/components/dropdown';
 import { AXDropdownModule } from '@acorex/components/dropdown';
 import { AXTextBoxModule } from '@acorex/components/text-box';
-import { AXToastService } from '@acorex/components/toast';
-import { RootConfig as RootConfig$1, axpAiChatMessagesFromProviderAssistant, axpAiParseDelegatedAgentResultSegmentsFromUnknown, axpAiChatTextMessage, AXPAiAssistChatModelCatalogService, axpAiParseSupervisorAgentToolName, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiDelegatedAgentPromptPreview, axpAiChatToolOrAgentResultBodyJson, axpAiDelegatedAgentOutcomeResponsesPlainText } from '@acorex/modules/ai-management';
 import * as i1 from '@angular/forms';
 import { FormsModule } from '@angular/forms';
 import { AXFabComponent, AXFabItemComponent } from '@acorex/components/fab';
@@ -98,6 +100,298 @@ const RootConfig = {
     },
 };
 
+/** Starts a new bot conversation with the given AI assist model. */
+const CONVERSATION_START_ASSIST_CHAT_COMMAND = 'Conversation:StartAssistChat';
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Participant & metadata ----
+/** Synthetic bot participant id for assist or agent-as-assist chats. */
+function axmChatAiPeerParticipantId(catalogId) {
+    return `assist-${catalogId.trim()}`;
+}
+/** Conversation metadata for starting an AI chat from a picker row. */
+function axmBuildAiChatConversationMetadata(row) {
+    if (row.kind === 'agent') {
+        return { directAgentId: row.id };
+    }
+    return { assistId: row.id };
+}
+/** True when conversation metadata targets an assist row or a direct agent-as-assist chat. */
+function axmConversationHasAiChat(conversation) {
+    const meta = conversation?.metadata;
+    if (!meta) {
+        return false;
+    }
+    const assistId = meta['assistId'];
+    if (typeof assistId === 'string' && assistId.trim()) {
+        return true;
+    }
+    const directAgentId = meta['directAgentId'];
+    return typeof directAgentId === 'string' && directAgentId.trim().length > 0;
+}
+/**
+ * Loads assist rows plus agents flagged with `isAssist` for Conversation AI chat pickers.
+ */
+async function axmLoadChatAiTargets(entityRegistry) {
+    const [assists, agents] = await Promise.all([
+        axmQueryEntityList(entityRegistry, RootConfig$1.entities.assist.name),
+        axmQueryEntityList(entityRegistry, RootConfig$1.entities.agent.name),
+    ]);
+    const assistRows = assists.map((raw) => ({
+        id: String(raw['id'] ?? ''),
+        name: String(raw['name'] ?? ''),
+        title: raw['title'],
+        description: raw['description'],
+        professionImageUrl: typeof raw['professionImageUrl'] === 'string' ? raw['professionImageUrl'] : undefined,
+        kind: 'assist',
+    }));
+    const agentRows = agents
+        .filter((raw) => raw['isAssist'] === true)
+        .map((raw) => ({
+        id: String(raw['id'] ?? ''),
+        name: String(raw['name'] ?? ''),
+        title: raw['title'],
+        description: raw['description'],
+        kind: 'agent',
+    }));
+    return [...assistRows, ...agentRows]
+        .filter((row) => row.id.trim().length > 0)
+        .sort((a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: 'base' }));
+}
+//#endregion
+//#region ---- Display & filter (dialog + global search) ----
+/** Resolves ML or plain string for search/display. */
+function axmResolveChatAiTargetText(resolveMl, value) {
+    if (!value) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    return resolveMl(value) ?? '';
+}
+function axmChatAiTargetDisplayName(resolveMl, row) {
+    return axmResolveChatAiTargetText(resolveMl, row.title).trim() || row.name.trim() || row.id;
+}
+function axmChatAiTargetDisplayDescription(resolveMl, row) {
+    if (!row.description) {
+        return undefined;
+    }
+    const text = axmResolveChatAiTargetText(resolveMl, row.description).trim();
+    return text || undefined;
+}
+function axmChatAiTargetAvatarUrl(row) {
+    const url = row.professionImageUrl?.trim();
+    return url ? url : null;
+}
+/** Fallback i18n key for rows with no catalog description. */
+function axmChatAiTargetShortcutDescriptionKey(row) {
+    return row.kind === 'agent'
+        ? '@conversation:search.assist.shortcut-description-agent'
+        : '@conversation:search.assist.shortcut-description';
+}
+/** Same filter as {@link AXMChatWithAssistDialogComponent} target list search. */
+function axmFilterChatAiTargets(resolveMl, rows, query) {
+    const q = query.trim().toLowerCase();
+    if (!q) {
+        return rows;
+    }
+    return rows.filter((r) => {
+        const titleText = axmResolveChatAiTargetText(resolveMl, r.title).toLowerCase();
+        return (r.name.toLowerCase().includes(q) ||
+            titleText.includes(q) ||
+            axmResolveChatAiTargetText(resolveMl, r.description).toLowerCase().includes(q));
+    });
+}
+//#endregion
+//#region ---- Entity list query ----
+async function axmQueryEntityList(entityRegistry, entityName) {
+    const entity = await entityRegistry.resolve(RootConfig$1.module.name, entityName);
+    const execute = entity.queries?.list?.execute;
+    if (!execute) {
+        throw new Error(`${entityName} entity has no list query.`);
+    }
+    const res = await execute({
+        skip: 0,
+        take: 500,
+        sort: [{ name: 'name', dir: 'asc' }],
+    });
+    return res.items ?? [];
+}
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Service ----
+/**
+ * Starts bot conversations from AI target rows (assists + agents with `isAssist`),
+ * shared by global search shortcuts and {@link AXMConversationStartAssistChatCommand}.
+ */
+class AXMChatAssistLauncherService {
+    constructor() {
+        this.conversationService = inject(AXConversationService);
+        this.entityRegistry = inject(AXPEntityDefinitionRegistryService);
+        this.translationService = inject(AXTranslationService);
+        this.sessionService = inject(AXPSessionService);
+        this.router = inject(Router);
+        this.toastService = inject(AXToastService);
+        this.targetsCache = null;
+        this.loadPromise = null;
+    }
+    async loadTargets(force = false) {
+        if (!force && this.targetsCache) {
+            return this.targetsCache;
+        }
+        if (!force && this.loadPromise) {
+            return this.loadPromise;
+        }
+        this.loadPromise = axmLoadChatAiTargets(this.entityRegistry);
+        try {
+            this.targetsCache = await this.loadPromise;
+            return this.targetsCache;
+        }
+        finally {
+            this.loadPromise = null;
+        }
+    }
+    displayName(row) {
+        return axmChatAiTargetDisplayName(this.#resolveMl.bind(this), row);
+    }
+    displayDescription(row) {
+        return axmChatAiTargetDisplayDescription(this.#resolveMl.bind(this), row);
+    }
+    targetAvatarUrl(row) {
+        return axmChatAiTargetAvatarUrl(row);
+    }
+    filterTargets(rows, query) {
+        return axmFilterChatAiTargets(this.#resolveMl.bind(this), rows, query);
+    }
+    async startAssistChat(options) {
+        const targetId = (options.targetId ?? options.assistId)?.trim();
+        if (!targetId) {
+            return null;
+        }
+        const rows = await this.loadTargets();
+        const row = rows.find((r) => r.id === targetId && (!options.targetKind || r.kind === options.targetKind)) ??
+            rows.find((r) => r.id === targetId);
+        if (!row) {
+            const message = await this.translationService.translateAsync('@conversation:chat.assist-dialog.errors.start-chat');
+            this.toastService.danger(message);
+            return null;
+        }
+        try {
+            const conversation = await this.#createTargetConversation(row);
+            await this.conversationService.selectConversation(conversation.id);
+            if (options.navigate !== false) {
+                await this.router.navigate([this.#applicationRouteSegment(), 'chat', conversation.id]);
+            }
+            return { conversation };
+        }
+        catch (error) {
+            console.error('Failed to start AI chat:', error);
+            const message = await this.translationService.translateAsync('@conversation:chat.assist-dialog.errors.start-chat');
+            this.toastService.danger(message);
+            return null;
+        }
+    }
+    async #createTargetConversation(row) {
+        const participantId = axmChatAiPeerParticipantId(row.id);
+        const title = this.displayName(row);
+        const avatar = this.targetAvatarUrl(row);
+        return this.conversationService.createConversation([participantId], 'bot', {
+            title,
+            ...(avatar ? { avatar } : {}),
+            icon: 'fa-solid fa-robot',
+            metadata: axmBuildAiChatConversationMetadata(row),
+        });
+    }
+    #resolveMl(value) {
+        return this.translationService.resolve(value);
+    }
+    #applicationRouteSegment() {
+        return this.sessionService.application?.name ?? 'platform';
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMChatAssistLauncherService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMChatAssistLauncherService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMChatAssistLauncherService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+/** Search group key — AI chat targets (assists + agent-as-assist), not conversation history. */
+const AXM_CONVERSATION_ASSIST_SEARCH_GROUP = 'conversation-assist';
+//#endregion
+//#region ---- Provider ----
+/**
+ * Global search entries to start a new AI chat — same catalog as
+ * {@link AXMChatWithAssistDialogComponent} / {@link AXMChatSidebarNewActionsComponent}.
+ *
+ * Note: the shared global search popup only queries when the text length is > 2.
+ */
+class AXMConversationAssistSearchProvider {
+    constructor() {
+        this.launcher = inject(AXMChatAssistLauncherService);
+    }
+    async search(text) {
+        let rows;
+        try {
+            rows = await this.launcher.loadTargets();
+        }
+        catch (error) {
+            console.error('Failed to load AI chat targets for shortcut search:', error);
+            return [];
+        }
+        const filtered = this.launcher.filterTargets(rows, text);
+        const sorted = sortBy(filtered, (row) => this.launcher.displayName(row).toLowerCase());
+        return sorted.map((row) => ({
+            id: row.id,
+            group: AXM_CONVERSATION_ASSIST_SEARCH_GROUP,
+            title: row.title,
+            description: row.description ?? axmChatAiTargetShortcutDescriptionKey(row),
+            icon: 'fa-solid fa-robot',
+            data: { id: row.id, name: row.name, kind: row.kind },
+            command: {
+                name: CONVERSATION_START_ASSIST_CHAT_COMMAND,
+                options: {
+                    targetId: row.id,
+                    targetKind: row.kind,
+                },
+            },
+        }));
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchProvider }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchProvider, decorators: [{
+            type: Injectable
+        }] });
+
+//#endregion
+//#region ---- Provider ----
+/** Search group for AI assist shortcut picker (not chat/conversation history). */
+class AXMConversationAssistSearchDefinitionProvider {
+    async provide(context) {
+        context.addDefinition(AXM_CONVERSATION_ASSIST_SEARCH_GROUP, '@conversation:search.assist.group-title', AXM_CONVERSATION_ASSIST_SEARCH_GROUP, 'fa-solid fa-robot', 4, {
+            format: {
+                id: '{{id}}',
+            },
+            actions: [
+                {
+                    name: 'start-assist-chat',
+                    type: AXPSystemActionType.View,
+                    priority: 'primary',
+                },
+            ],
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchDefinitionProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchDefinitionProvider }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMConversationAssistSearchDefinitionProvider, decorators: [{
+            type: Injectable
+        }] });
+
 class AXMConversationTabService extends AXMEntityCrudServiceImpl {
 }
 class AXMConversationTabServiceImpl extends AXMConversationTabService {
@@ -922,6 +1216,12 @@ const AXPConversationMenuKeys = {
     Conversations: 'Conversation:Menu:Conversations',
 };
 
+const AXMPermissionsKeys = {
+    Conversation: {
+        Management: 'Conversation:Permission:Management',
+    },
+};
+
 class AXMMenuProvider {
     constructor() {
         this.sessionService = inject(AXPSessionService);
@@ -937,6 +1237,9 @@ class AXMMenuProvider {
                 priority: 30,
                 icon: RootConfig.entities.room.icon,
                 badgeKey: 'badge-chat',
+                policy: {
+                    permissions: [AXMPermissionsKeys.Conversation.Management],
+                },
             },
         ]);
     }
@@ -947,9 +1250,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             type: Injectable
         }] });
 
+//#endregion
+//#region ----   Permission Definition Provider   ----
 class AXMPermissionDefinitionProvider {
     async define(context) {
-        // TODO: Define permissions when needed
+        const keys = AXMPermissionsKeys.Conversation;
+        const modulePermissions = '@conversation:module.permissions';
+        context
+            .addGroup(RootConfig.module.name, `${modulePermissions}.title`, `${modulePermissions}.description`)
+            .addPermission(keys.Management, `${modulePermissions}.manage.title`, `${modulePermissions}.manage.description`)
+            .endPermission()
+            .endGroup();
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMPermissionDefinitionProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMPermissionDefinitionProvider }); }
@@ -1635,77 +1946,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             args: [{ providedIn: 'root' }]
         }], ctorParameters: () => [] });
 
-//#region ---- Imports ----
-//#endregion
-//#region ---- Participant & metadata ----
-/** Synthetic bot participant id for assist or agent-as-assist chats. */
-function axmChatAiPeerParticipantId(catalogId) {
-    return `assist-${catalogId.trim()}`;
-}
-/** Conversation metadata for starting an AI chat from a picker row. */
-function axmBuildAiChatConversationMetadata(row) {
-    if (row.kind === 'agent') {
-        return { directAgentId: row.id };
-    }
-    return { assistId: row.id };
-}
-/** True when conversation metadata targets an assist row or a direct agent-as-assist chat. */
-function axmConversationHasAiChat(conversation) {
-    const meta = conversation?.metadata;
-    if (!meta) {
-        return false;
-    }
-    const assistId = meta['assistId'];
-    if (typeof assistId === 'string' && assistId.trim()) {
-        return true;
-    }
-    const directAgentId = meta['directAgentId'];
-    return typeof directAgentId === 'string' && directAgentId.trim().length > 0;
-}
-/**
- * Loads assist rows plus agents flagged with `isAssist` for Conversation AI chat pickers.
- */
-async function axmLoadChatAiTargets(entityRegistry) {
-    const [assists, agents] = await Promise.all([
-        axmQueryEntityList(entityRegistry, RootConfig$1.entities.assist.name),
-        axmQueryEntityList(entityRegistry, RootConfig$1.entities.agent.name),
-    ]);
-    const assistRows = assists.map((raw) => ({
-        id: String(raw['id'] ?? ''),
-        name: String(raw['name'] ?? ''),
-        title: raw['title'],
-        description: raw['description'],
-        professionImageUrl: typeof raw['professionImageUrl'] === 'string' ? raw['professionImageUrl'] : undefined,
-        kind: 'assist',
-    }));
-    const agentRows = agents
-        .filter((raw) => raw['isAssist'] === true)
-        .map((raw) => ({
-        id: String(raw['id'] ?? ''),
-        name: String(raw['name'] ?? ''),
-        title: raw['title'],
-        description: raw['description'],
-        kind: 'agent',
-    }));
-    return [...assistRows, ...agentRows]
-        .filter((row) => row.id.trim().length > 0)
-        .sort((a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: 'base' }));
-}
-async function axmQueryEntityList(entityRegistry, entityName) {
-    const entity = await entityRegistry.resolve(RootConfig$1.module.name, entityName);
-    const execute = entity.queries?.list?.execute;
-    if (!execute) {
-        throw new Error(`${entityName} entity has no list query.`);
-    }
-    const res = await execute({
-        skip: 0,
-        take: 500,
-        sort: [{ name: 'name', dir: 'asc' }],
-    });
-    return res.items ?? [];
-}
-//#endregion
-
 class AXMChatEmptyAssistComposerComponent {
     constructor() {
         this.conversationService = inject(AXConversationService);
@@ -2035,33 +2275,13 @@ class AXMChatWithAssistDialogComponent extends AXBasePageComponent {
         }
     }
     filteredTargetRows() {
-        const q = this.searchQuery().toLowerCase().trim();
-        const list = this.rows();
-        if (!q) {
-            return list;
-        }
-        return list.filter((r) => {
-            const titleText = this.resolveSearchableTitle(r.title).toLowerCase();
-            return (r.name.toLowerCase().includes(q) ||
-                titleText.includes(q) ||
-                this.resolveSearchableTitle(r.description).toLowerCase().includes(q));
-        });
-    }
-    resolveSearchableTitle(value) {
-        if (!value) {
-            return '';
-        }
-        if (typeof value === 'string') {
-            return value;
-        }
-        return this.translationService.resolve(value) ?? '';
+        return axmFilterChatAiTargets((value) => this.translationService.resolve(value), this.rows(), this.searchQuery());
     }
     displayName(row) {
-        return this.resolveSearchableTitle(row.title).trim() || row.name?.trim() || row.id;
+        return axmChatAiTargetDisplayName((value) => this.translationService.resolve(value), row);
     }
     targetAvatarUrl(row) {
-        const avatarUrl = row.professionImageUrl?.trim();
-        return avatarUrl ? avatarUrl : null;
+        return axmChatAiTargetAvatarUrl(row);
     }
     onCancel() {
         const event = new AXComponentCloseEvent();
@@ -2171,7 +2391,7 @@ class AXMChatWithAssistDialogComponent extends AXBasePageComponent {
         <div class="user-item-content">
           <ax-avatar [size]="54">
             @if (targetAvatarUrl(row); as avatarUrl) {
-              <ax-image [src]="avatarUrl" [alt]="displayName(row) | translate | async"></ax-image>
+              <ax-image [src]="avatarUrl" [alt]="row.title | translate | async"></ax-image>
             } @else {
               <ax-icon
                 ><i
@@ -2188,7 +2408,7 @@ class AXMChatWithAssistDialogComponent extends AXBasePageComponent {
             }
           </ax-avatar>
           <div class="user-item-text">
-            <span class="ax-truncated user-name-text">{{ displayName(row) | translate | async }}</span>
+            <span class="ax-truncated user-name-text">{{ row.title | translate | async }}</span>
             @if (row.description) {
               <span class="user-description-text ax-truncated">{{ row.description | translate | async }}</span>
             }
@@ -2277,7 +2497,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
         <div class="user-item-content">
           <ax-avatar [size]="54">
             @if (targetAvatarUrl(row); as avatarUrl) {
-              <ax-image [src]="avatarUrl" [alt]="displayName(row) | translate | async"></ax-image>
+              <ax-image [src]="avatarUrl" [alt]="row.title | translate | async"></ax-image>
             } @else {
               <ax-icon
                 ><i
@@ -2294,7 +2514,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             }
           </ax-avatar>
           <div class="user-item-text">
-            <span class="ax-truncated user-name-text">{{ displayName(row) | translate | async }}</span>
+            <span class="ax-truncated user-name-text">{{ row.title | translate | async }}</span>
             @if (row.description) {
               <span class="user-description-text ax-truncated">{{ row.description | translate | async }}</span>
             }
@@ -4981,7 +5201,7 @@ async function axmOpenAssistDelegatedAgentDetailDialog(options) {
         options.translationService.translateAsync('@conversation:chat.assist-renderer.delegated-agent.dialog-title-suffix'),
         options.translationService.translateAsync('@conversation:chat.assist-renderer.delegated-agent.transcript-missing'),
     ]);
-    const comp = (await import('./acorex-modules-conversation-assist-delegated-agent-detail-popup.component-DnKfkEg1.mjs'))
+    const comp = (await import('./acorex-modules-conversation-assist-delegated-agent-detail-popup.component-BB5Uyydt.mjs'))
         .AXMAssistDelegatedAgentDetailPopupComponent;
     const data = {
         messages: entry?.messages ?? [],
@@ -6028,7 +6248,7 @@ class AXMCommentsPageComponentProvider {
         return [
             {
                 key: COMMENTS_PAGE_COMPONENT_KEY,
-                loader: () => import('./acorex-modules-conversation-comments-page.component-JPIzhBys.mjs').then((m) => m.AXMCommentsPageComponent),
+                loader: () => import('./acorex-modules-conversation-comments-page.component-QnDogSDy.mjs').then((m) => m.AXMCommentsPageComponent),
             },
         ];
     }
@@ -6194,6 +6414,22 @@ class AXMConversationModule {
                 useClass: AXMConversationWidgetsProvider,
                 multi: true,
             },
+            {
+                provide: AXP_SEARCH_PROVIDER,
+                useClass: AXMConversationAssistSearchProvider,
+                multi: true,
+            },
+            {
+                provide: AXP_SEARCH_DEFINITION_PROVIDER,
+                useClass: AXMConversationAssistSearchDefinitionProvider,
+                multi: true,
+            },
+            provideCommandSetups([
+                {
+                    key: CONVERSATION_START_ASSIST_CHAT_COMMAND,
+                    command: () => import('./acorex-modules-conversation-start-assist-chat.command-DRlWzEDp.mjs').then((m) => m.AXMConversationStartAssistChatCommand),
+                },
+            ]),
         ], imports: [AXPWidgetCoreModule,
             AXPWorkflowModule.forChild({
                 actions: {
@@ -6305,6 +6541,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
                             useClass: AXMConversationWidgetsProvider,
                             multi: true,
                         },
+                        {
+                            provide: AXP_SEARCH_PROVIDER,
+                            useClass: AXMConversationAssistSearchProvider,
+                            multi: true,
+                        },
+                        {
+                            provide: AXP_SEARCH_DEFINITION_PROVIDER,
+                            useClass: AXMConversationAssistSearchDefinitionProvider,
+                            multi: true,
+                        },
+                        provideCommandSetups([
+                            {
+                                key: CONVERSATION_START_ASSIST_CHAT_COMMAND,
+                                command: () => import('./acorex-modules-conversation-start-assist-chat.command-DRlWzEDp.mjs').then((m) => m.AXMConversationStartAssistChatCommand),
+                            },
+                        ]),
                     ],
                 }]
         }] });
@@ -6313,5 +6565,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AXMCommentComponent as A, AXMConversationTabEntityModule as B, AXMConversationTabService as C, AXMConversationTabServiceImpl as D, AXMMessageEntityModule as E, AXMMessageService as F, AXMMessageServiceImpl as G, AXMRoomEntityModule as H, AXMRoomService as I, AXMRoomServiceImpl as J, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE as K, AXPCommentWidget as L, COMMENTS_PAGE_COMPONENT_KEY as M, axmAssistLastTranscriptLine as N, axmAssistUserVisibleItemsForLine as O, axmBuildAssistTranscriptLinePayload as P, axmIsAssistPeerParticipant as Q, RootConfig as R, axmNormalizeAssistTranscriptForChatUi as S, axmNormalizeAssistTranscriptLineResponses as T, axmParseAssistTranscriptLinePayload as U, axmReadAssistAiTranscript as V, axmReadAssistAiTranscriptRaw as W, commentsPlugin as X, messageFactory as Y, roomFactory as Z, tabFactory as _, axmAssistSegmentDirection as a, axmParseAssistTranscriptTextEnvelope as b, axmAssistWidgetNodeFromUnknown as c, axmSyntheticEmbedMessage as d, AXMNodeMessageRendererComponent as e, AXMAssistBotImageLineComponent as f, AXMChatComponent as g, AXMChatConversationApi as h, AXMChatManagementService as i, AXMChatMessageApi as j, AXMChatRealtimeApi as k, AXMChatRealtimeService as l, AXMChatRealtimeServiceImpl as m, AXMChatService as n, AXMChatServiceImpl as o, AXMChatUserApi as p, AXMCommentManagementService as q, AXMCommentPopupComponent as r, AXMCommentPopupStartAction as s, AXMCommentPopupWorkflow as t, AXMCommentRealtimeService as u, AXMCommentRealtimeServiceImpl as v, AXMCommentService as w, AXMCommentServiceImpl as x, AXMCommentWidgetViewComponent as y, AXMConversationModule as z };
-//# sourceMappingURL=acorex-modules-conversation-acorex-modules-conversation-Dm9D7la2.mjs.map
+export { roomFactory as $, AXMChatAssistLauncherService as A, AXMConversationModule as B, AXMConversationTabEntityModule as C, AXMConversationTabService as D, AXMConversationTabServiceImpl as E, AXMMessageEntityModule as F, AXMMessageService as G, AXMMessageServiceImpl as H, AXMPermissionsKeys as I, AXMRoomEntityModule as J, AXMRoomService as K, AXMRoomServiceImpl as L, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE as M, AXPCommentWidget as N, COMMENTS_PAGE_COMPONENT_KEY as O, axmAssistLastTranscriptLine as P, axmAssistUserVisibleItemsForLine as Q, RootConfig as R, axmBuildAssistTranscriptLinePayload as S, axmIsAssistPeerParticipant as T, axmNormalizeAssistTranscriptForChatUi as U, axmNormalizeAssistTranscriptLineResponses as V, axmParseAssistTranscriptLinePayload as W, axmReadAssistAiTranscript as X, axmReadAssistAiTranscriptRaw as Y, commentsPlugin as Z, messageFactory as _, AXMCommentComponent as a, tabFactory as a0, axmAssistSegmentDirection as b, axmParseAssistTranscriptTextEnvelope as c, axmAssistWidgetNodeFromUnknown as d, axmSyntheticEmbedMessage as e, AXMNodeMessageRendererComponent as f, AXMAssistBotImageLineComponent as g, AXMChatComponent as h, AXMChatConversationApi as i, AXMChatManagementService as j, AXMChatMessageApi as k, AXMChatRealtimeApi as l, AXMChatRealtimeService as m, AXMChatRealtimeServiceImpl as n, AXMChatService as o, AXMChatServiceImpl as p, AXMChatUserApi as q, AXMCommentManagementService as r, AXMCommentPopupComponent as s, AXMCommentPopupStartAction as t, AXMCommentPopupWorkflow as u, AXMCommentRealtimeService as v, AXMCommentRealtimeServiceImpl as w, AXMCommentService as x, AXMCommentServiceImpl as y, AXMCommentWidgetViewComponent as z };
+//# sourceMappingURL=acorex-modules-conversation-acorex-modules-conversation-F7nQo1GU.mjs.map