@acorex-platform/module-conversation-client 0.0.46 → 0.0.48

package/types/acorex-platform-module-conversation-client.d.ts

@@ -1,19 +1,20 @@
 import * as _angular_core from '@angular/core';
-import { Provider, InjectionToken, Type, Signal, OnInit, ElementRef, DestroyRef, OnDestroy } from '@angular/core';
+import { Provider, ElementRef, InjectionToken, Type, Signal, OnInit, DestroyRef, OnDestroy } from '@angular/core';
 import * as i1 from '@acorex-platform/framework-client/layout/widget-core';
 import { AXPValueWidgetComponent } from '@acorex-platform/framework-client/layout/widget-core';
 import { AXPBackgroundOperationHandler, AXPBackgroundOperation, AXPFileStorageService } from '@acorex-platform/framework-client/common';
 import * as _acorex_platform_framework_shared_core from '@acorex-platform/framework-shared/core';
 import { AXPExecuteCommand, AXPFilterDefinition, AXPFilterQuery, AXPActionMenuItem, AXPMultiLanguageString, AXPWidgetNode, AXPUserReference, AXPEntityReference } from '@acorex-platform/framework-shared/core';
 import { AXPPageLayoutBaseComponent } from '@acorex-platform/framework-client/layout/views';
-import { AXMChannelFeedItem, AXMConversationRoom, AXMConversationMessage, AXMCommentEntityData, AXReaction, AXMessagePayload, AXMReactionType } from '@acorex-platform/module-conversation-client/contracts';
+import { AXMChannelFeedItem, AXMConversationRoom, AXMConversationMessage, AXMCommentEntityData as AXMCommentEntityData$1, AXReaction, AXMessagePayload, AXMReactionType } from '@acorex-platform/module-conversation-client/contracts';
 import { Routes } from '@angular/router';
-import { AXClickEvent, AXStyleLookType, AXPlacement } from '@acorex/cdk/common';
+import { AXClickEvent, AXPlacement, AXStyleLookType } from '@acorex/cdk/common';
 import { AXPDeviceService } from '@acorex-platform/framework-client/core';
 import * as _acorex_components_conversation from '@acorex/components/conversation';
 import { AXConversationApi, AXConversation, AXConversationMessageApi, AXConversationMessage, AXConversationRealtimeApi, AXConversationUserApi, AXConversationPagination, AXConversationPaginatedResult, AXConversationCreateData, AXConversationFilters, AXConversationUpdateData, AXConversationParticipant, AXConversationParticipantUpdate, AXConversationSendMessageCommand, AXConversationMessagePayload, AXConversationMessageSearchFilters, AXConversationReadReceipt, AXConversationMessageForwardData, AXConversationPinnedMessage, AXConversationTypingIndicator, AXConversationUser, AXConversationUserProfileUpdate, AXConversationUserSearchFilters, AXConversationPresenceUpdate, AXConversationPresenceStatus, AXConversationBlockReportReason, AXConversationRoomPreferencesMap, AXConversationRoomPreferences, AXConversationTab, AXConversationConnectionStatus, AXConversationService } from '@acorex/components/conversation';
+import { AXMCommentEntityData, AXMContextualAssistContext } from '@acorex-platform/module-conversation-client/contracts';
+export { AXMContextualAssistContext, AXM_CONTEXTUAL_ASSIST_KIND_ENTITY_RECORD } from '@acorex-platform/module-conversation-client/contracts';
 import { Observable } from 'rxjs';
-import { AXMContextualAssistContext, AXMCommentEntityData as AXMCommentEntityData$1 } from '@acorex-platform/module-conversation-client/contracts';
 import { AXPEntityDefinitionRegistryService, AXPEntityActionPlugin } from '@acorex-platform/framework-client/layout/entity';
 import { AXPopupRef, AXPopupComponentBase } from '@acorex/components/popup';
 import { AXPAiChatResponse, AXPAiChatMessage, AXPAiChatFollowUpItem } from '@acorex-platform/module-ai-management-client';
@@ -230,6 +231,232 @@ declare function persistChatAttachment(fileStorage: AXPFileStorageService, file:
     fileId: string;
 }>;
 
+/** Entity reference an entity-scoped chat is bound to (stored in conversation metadata). */
+interface AXMEntityChatRef {
+    entityId: string;
+    entityType: string;
+}
+/** Room fields used to decide whether a chat belongs on the main inbox. */
+interface AXMEntityChatRoomRef {
+    metadata?: Record<string, unknown>;
+    entityRef?: Pick<AXMCommentEntityData, 'entityId' | 'entityTypeId'> | null;
+}
+/** Room metadata flag: entity mini-chats stay off `/chat/`; header inbox chats omit this. */
+declare const AXM_MINI_CHAT_SCOPE_METADATA_KEY = "miniChatScope";
+declare const AXM_MINI_CHAT_SCOPE_ENTITY = "entity";
+/**
+ * Synthetic record id for Ask AI on an entity **list** (no row id).
+ * Keeps list history on that page and out of the main chat sidebar.
+ */
+declare const AXM_ENTITY_LIST_CHAT_ID = "__entity-list__";
+/**
+ * Conversation metadata for an entity-scoped assist chat.
+ * Keeps `assistId` so the existing assist reply pipeline still answers in entity chats.
+ */
+declare function axmBuildEntityChatConversationMetadata(args: {
+    entityId: string;
+    entityType: string;
+    assistId: string;
+}): Record<string, unknown>;
+/**
+ * `AXConversationService.createConversation` stores the whole UI options object as
+ * `room.metadata`, nesting real keys under `metadata.metadata`. Flatten so entity
+ * flags sit at the top level for inbox filters and `entityRef`.
+ */
+declare function axmFlattenConversationCreateMetadata(metadata: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+/**
+ * Resolves the entity reference from conversation metadata.
+ * `AXConversationService.createConversation` may nest the UI object, so values
+ * are also probed at `metadata.metadata.*`.
+ */
+declare function axmExtractEntityRefFromMetadata(metadata: Record<string, unknown> | undefined): AXMEntityChatRef | undefined;
+/** Entity id/type from a contextual-assist launch payload (entity row / details). */
+declare function axmEntityRefFromLaunchContext(launch: AXMContextualAssistContext | undefined): AXMEntityChatRef | undefined;
+/** True when the conversation is bound to an entity page (not the site-header inbox). */
+declare function axmConversationIsEntityChat(metadata: Record<string, unknown> | undefined): boolean;
+/** True when conversation metadata targets the given entity reference. */
+declare function axmConversationMatchesEntity(metadata: Record<string, unknown> | undefined, ref: AXMEntityChatRef): boolean;
+/**
+ * True when a persisted room is an entity-scoped chat (metadata and/or `entityRef`).
+ * Header / inbox AI chats have neither; they belong on `/chat/`.
+ */
+declare function axmRoomIsEntityChat(room: AXMEntityChatRoomRef | null | undefined): boolean;
+/** True when a room is bound to the given entity via metadata or `entityRef`. */
+declare function axmRoomMatchesEntity(room: AXMEntityChatRoomRef | null | undefined, ref: AXMEntityChatRef): boolean;
+/**
+ * Persisted `entityRef` for an entity-scoped chat room so history can query by record
+ * and the main inbox can exclude the room (comment threads use `kind: 'comment'`).
+ */
+declare function axmBuildEntityChatRoomEntityRef(metadata: Record<string, unknown> | undefined): AXMCommentEntityData | undefined;
+/** Launch context stored on a chat room, including the nested metadata shape. */
+declare function axmRoomLaunchContext(room: AXMEntityChatRoomRef | null | undefined): AXMContextualAssistContext | undefined;
+
+type AXMMiniChatContextChipKind = 'entity' | 'view' | 'record';
+interface AXMMiniChatContextChip {
+    id: string;
+    kind: AXMMiniChatContextChipKind;
+    label: string;
+}
+interface AXMMiniChatPageContextDraft {
+    moduleName: string;
+    entityName: string;
+    entityTitle: string;
+    entityKey: string;
+    viewName?: string;
+    viewTitle?: string;
+    viewKey: string;
+    includeView: boolean;
+    records: Array<{
+        id: string;
+        title: string;
+    }>;
+    selectionKey: string;
+}
+
+/** Anchor element for overlay positioning. */
+type AXMMiniChatPanelAnchor = Element | ElementRef<HTMLElement>;
+/**
+ * Common placement aliases mapped to {@link AXPlacement}.
+ * Examples: `top-right` → `top-end`, `bottom-left` → `bottom-start`.
+ */
+type AXMMiniChatPanelSide = AXPlacement | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
+/** Fixed viewport coordinates (px). Ignored when `anchor` is set. */
+interface AXMMiniChatPanelPosition {
+    x: number;
+    y: number;
+}
+/** Mini chat panel scope: entity-bound threads or main inbox (non-entity chats). */
+type AXMMiniChatPanelScope = 'entity' | 'inbox';
+/**
+ * Who picks the assist on a new mini-chat thread.
+ * `ask` prompts before the first message (header inbox).
+ * `locked` keeps the caller assist and hides the picker (form designer).
+ * `optional` preselects the tenant default and still allows a change.
+ */
+type AXMMiniChatAssistSelection = 'ask' | 'locked' | 'optional';
+/**
+ * How the shared panel is hosted.
+ * `overlay` is the floating window (header / entity pages).
+ * `embedded` fills the host (entity record details, later).
+ */
+type AXMMiniChatPanelPresentation = 'overlay' | 'embedded';
+/** Session key used for the global inbox mini chat (non-entity conversations). */
+declare const AXM_MINI_CHAT_INBOX_SESSION_KEY = "__inbox__";
+/** Popup dock name for minimized mini-chat tabs in the root footer. */
+declare const AXM_MINI_CHAT_POPUP_DOCK = "mini-chat";
+/** Persisted panel state for a mini chat session. */
+interface AXMMiniChatPanelSessionState {
+    view: 'thread' | 'history';
+    selectedChatId?: string;
+    hasOpened: boolean;
+    /** Page the thread belongs to (`Module.Entity:id`, `Module.Entity:list`, or `global`). */
+    pageKey?: string;
+}
+/** Options passed to {@link AXMMiniChatPanelService.open}. */
+interface AXMMiniChatPanelOpenOptions {
+    /** Default: `entity`. Use `inbox` for regular (non-entity) chats shown in the main chat sidebar. */
+    scope?: AXMMiniChatPanelScope;
+    entityId?: string;
+    entityType?: string;
+    assistId?: string;
+    /** Default: `optional`. Header inbox uses `ask`; form designer uses `locked`. */
+    assistSelection?: AXMMiniChatAssistSelection;
+    title?: string;
+    showInfoBar?: boolean;
+    showComposer?: boolean;
+    /** Default: `overlay`. Use `embedded` when the panel is inlined in a page. */
+    presentation?: AXMMiniChatPanelPresentation;
+    /** Fixed viewport position (px). Ignored when `anchor` is set. */
+    position?: AXMMiniChatPanelPosition;
+    /** Anchor element for popover placement. */
+    anchor?: AXMMiniChatPanelAnchor;
+    /** Placement relative to anchor. Default: `top-end` when anchored. */
+    placement?: AXMMiniChatPanelSide;
+    offsetX?: number;
+    offsetY?: number;
+    autoFlip?: boolean;
+    /** When true, always opens a fresh conversation thread. */
+    forceNewChat?: boolean;
+    /** Default: true. Form-designer assist hides this control. */
+    minimizable?: boolean;
+    /**
+     * When true, the close button hides the live window instead of destroying it.
+     * The next open for the same session shows that same instance.
+     */
+    retainOnClose?: boolean;
+    /**
+     * Record/surface context for a new assist thread (entity-row assist).
+     * Stored on the room and used to generate contextual starter chips.
+     */
+    launchContext?: AXMContextualAssistContext;
+}
+/** Window controls exposed by the mini-chat popup host to {@link AXMMiniChatPanelService}. */
+interface AXMMiniChatPopupWindowApi {
+    close(): void;
+    restore(): void;
+    minimize(): void;
+    maximize(): void;
+    hide(): void;
+    show(): void;
+    isMinimized(): boolean;
+    isMaximized(): boolean;
+    isHidden(): boolean;
+}
+/** Assigned onto {@link AXMMiniChatPopupWindowComponent} via popup `data`. */
+interface AXMMiniChatPopupWindowData {
+    scope: AXMMiniChatPanelScope;
+    entityId?: string;
+    entityType?: string;
+    assistId?: string;
+    assistSelection: AXMMiniChatAssistSelection;
+    panelTitle?: string;
+    showInfoBar: boolean;
+    showComposer: boolean;
+    initialView: 'thread' | 'history';
+    initialConversationId?: string;
+    startWithNewChat: boolean;
+    launchContext?: AXMContextualAssistContext;
+    minimizable: boolean;
+    retainOnClose: boolean;
+    onSessionChange?: (state: Pick<AXMMiniChatPanelSessionState, 'view' | 'selectedChatId'>) => void;
+    onVisibilityChange?: (visible: boolean) => void;
+    registerWindow?: (api: AXMMiniChatPopupWindowApi | null) => void;
+}
+
+/** Whose chats a mini-chat history list is allowed to show. */
+type AXMMiniChatHistoryScope = {
+    mode: 'global';
+} | {
+    mode: 'entity';
+    entityType: string;
+    entityIds: string[];
+} | {
+    mode: 'launch';
+    kind: string;
+    actionName: string;
+    recordId: string;
+};
+/** Header chips: a record chip binds that record, an entity chip binds the list, neither is global. */
+declare function axmMiniChatHistoryScopeFromDraft(draft: AXMMiniChatPageContextDraft | null, chips: readonly AXMMiniChatContextChip[]): AXMMiniChatHistoryScope;
+/**
+ * Fixed surfaces (form designer, entity window).
+ * Plain header inbox returns null so the live chips decide.
+ */
+declare function axmMiniChatHistoryScopeFromOpen(options: {
+    scope: AXMMiniChatPanelScope;
+    entityId?: string;
+    entityType?: string;
+    launchContext?: AXMContextualAssistContext;
+}): AXMMiniChatHistoryScope | null;
+/** Entity binding stamped on a new header chat so it stays out of global history. */
+declare function axmEntityRefForMiniChatPageContext(launch: AXMContextualAssistContext | undefined): AXMEntityChatRef | undefined;
+declare function axmMiniChatHistoryScopeKey(scope: AXMMiniChatHistoryScope): string;
+/** Chats with no entity and no surface context. These are the only rooms on `/chat/`. */
+declare function axmConversationIsGlobalChat(room: AXMEntityChatRoomRef | null | undefined): boolean;
+declare function axmConversationMatchesHistoryScope(room: AXMEntityChatRoomRef | null | undefined, scope: AXMMiniChatHistoryScope): boolean;
+/** True when this open window still belongs to the route the user is on. Header inbox follows every route. */
+declare function axmMiniChatWindowOwnsRoute(options: Pick<AXMMiniChatPanelOpenOptions, 'scope' | 'entityId' | 'entityType' | 'launchContext'>, params: Record<string, string>): boolean;
+
 /** User profile, discovery, and presence for conversation chat. */
 declare abstract class AXMChatUserApi extends AXConversationUserApi {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMChatUserApi, never>;
@@ -244,6 +471,8 @@ declare abstract class AXMChatConversationApi extends AXConversationApi {
      * Bypasses the regular inbox filtering so entity chats remain discoverable per entity.
      */
     abstract findEntityConversations(entityType: string, entityId: string): Promise<AXConversation[]>;
+    /** Chat rooms that belong to one mini-chat history scope (global, entity, or a surface such as form designer). */
+    abstract findHistoryConversations(scope: AXMMiniChatHistoryScope): Promise<AXConversation[]>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMChatConversationApi, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMChatConversationApi>;
 }
@@ -335,6 +564,7 @@ declare class AXMChatEntityConversationApi extends AXMChatConversationApi {
     searchConversations(query: string): Promise<AXConversation[]>;
     filterConversations(filters: AXConversationFilters, pagination?: AXConversationPagination): Promise<AXConversationPaginatedResult<AXConversation>>;
     findEntityConversations(entityType: string, entityId: string): Promise<AXConversation[]>;
+    findHistoryConversations(scope: AXMMiniChatHistoryScope): Promise<AXConversation[]>;
     getParticipants(conversationId: string): Promise<AXConversationParticipant[]>;
     addParticipants(conversationId: string, userIds: string[]): Promise<AXConversation>;
     /**
@@ -396,6 +626,8 @@ declare class AXMChatEntityConversationRoomQueryService {
     private readonly roomData;
     private readonly messageData;
     loadChatRooms(): Promise<AXMConversationRoom[]>;
+    /** Every chat room the current user can open, including entity and surface mini chats. */
+    loadAccessibleChatRooms(): Promise<AXMConversationRoom[]>;
     enrichRoom(room: AXMConversationRoom, options?: {
         probeLastMessage?: boolean;
         currentUserId?: string;
@@ -584,9 +816,9 @@ declare const AXM_CHAT_SIDEBAR_ACTION_PROVIDER: InjectionToken<AXMChatSidebarAct
 
 /** True when the conversation is an assist / AI bot chat. */
 declare function axmIsAssistBotConversation(conversation: AXConversation): boolean;
-/** Inbox (`/chat/`) must not list entity-record mini chats. */
+/** Inbox (`/chat/`) lists only global chats: no entity, record, or surface such as form designer. */
 declare function axmExcludeEntityChatConversations(conversations: AXConversation[]): AXConversation[];
-/** Wraps a sidebar tab so entity-scoped chats stay off the main chat list. */
+/** Wraps a sidebar tab so only global chats stay on the main chat list. */
 declare function axmInboxConversationTab(tab: AXConversationTab): AXConversationTab;
 /** Sidebar tab for AI assist conversations (`type: 'bot'` or assist metadata). */
 declare const AXM_CONVERSATION_TAB_BOT: AXConversationTab;
@@ -666,6 +898,7 @@ interface AXMChatEmptyAssistSessionBind {
     entityId?: string;
     entityType?: string;
     launchContext?: AXMContextualAssistContext;
+    assistSelection?: AXMMiniChatAssistSelection;
 }
 /**
  * Shared new-chat assist selection for the empty-state welcome UI and the real
@@ -687,6 +920,7 @@ declare class AXMChatEmptyAssistSessionService {
     readonly entityId: _angular_core.WritableSignal<string | undefined>;
     readonly entityType: _angular_core.WritableSignal<string | undefined>;
     readonly launchContext: _angular_core.WritableSignal<AXMContextualAssistContext | undefined>;
+    readonly assistSelection: _angular_core.WritableSignal<AXMMiniChatAssistSelection>;
     readonly assistPickerOpen: _angular_core.WritableSignal<boolean>;
     private ensurePromise;
     bind(input: AXMChatEmptyAssistSessionBind): void;
@@ -1288,14 +1522,14 @@ declare class AXMCommentManagementService {
     private formatComment;
     private buildCommentTree;
     private formatThread;
-    createThread(entityRef: AXMCommentEntityData, topic: string, title?: string): Promise<AXMCommentThread>;
-    getThread(entityRef: AXMCommentEntityData, topic: string): Promise<AXMCommentThread | null>;
-    countCommentsForEntity(entityRef: AXMCommentEntityData): Promise<number>;
-    listThreads(entityRef: AXMCommentEntityData, topic: string): Promise<AXMCommentThread[]>;
-    updateThread(entityRef: AXMCommentEntityData, topic: string, data: Partial<{
+    createThread(entityRef: AXMCommentEntityData$1, topic: string, title?: string): Promise<AXMCommentThread>;
+    getThread(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMCommentThread | null>;
+    countCommentsForEntity(entityRef: AXMCommentEntityData$1): Promise<number>;
+    listThreads(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMCommentThread[]>;
+    updateThread(entityRef: AXMCommentEntityData$1, topic: string, data: Partial<{
         title: string;
     }>): Promise<AXMCommentThread>;
-    deleteThread(entityRef: AXMCommentEntityData, topic: string): Promise<boolean>;
+    deleteThread(entityRef: AXMCommentEntityData$1, topic: string): Promise<boolean>;
     addComment(threadId: string, content: string, parentCommentId?: string, contentType?: string, userId?: string): Promise<AXMComment>;
     getComments(threadId: string, nested: boolean): Promise<AXMComment[]>;
     getComment(commentId: string): Promise<AXMComment>;
@@ -1417,13 +1651,13 @@ declare class AXMCommentComponent implements OnInit {
 declare function axmExtractTextFromPayload(payload: AXMessagePayload | undefined): string;
 
 declare abstract class AXMCommentService {
-    abstract createThread(entityRef: AXMCommentEntityData, topic: string, title?: string): Promise<AXMCommentThread>;
-    abstract getThread(entityRef: AXMCommentEntityData, topic: string): Promise<AXMCommentThread | null>;
-    abstract listThreads(entityRef: AXMCommentEntityData, topic: string): Promise<AXMCommentThread[]>;
-    abstract updateThread(entityRef: AXMCommentEntityData, topic: string, data: Partial<{
+    abstract createThread(entityRef: AXMCommentEntityData$1, topic: string, title?: string): Promise<AXMCommentThread>;
+    abstract getThread(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMCommentThread | null>;
+    abstract listThreads(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMCommentThread[]>;
+    abstract updateThread(entityRef: AXMCommentEntityData$1, topic: string, data: Partial<{
         title: string;
     }>): Promise<AXMCommentThread>;
-    abstract deleteThread(entityRef: AXMCommentEntityData, topic: string): Promise<boolean>;
+    abstract deleteThread(entityRef: AXMCommentEntityData$1, topic: string): Promise<boolean>;
     abstract addComment(threadId: string, content: string, parentCommentId?: string, contentType?: string, userId?: string): Promise<AXMComment>;
     abstract getComments(threadId: string, nested: boolean): Promise<AXMComment[]>;
     abstract getComment(commentId: string): Promise<AXMComment>;
@@ -1443,10 +1677,10 @@ declare class AXMCommentServiceImpl {
     private readonly messageService;
     private readonly filterService;
     private readonly translationService;
-    createThread(creatorUser: AXPUserReference, entityRef: AXMCommentEntityData, topic: string, title?: string): Promise<AXMConversationRoom>;
-    getThread(entityRef: AXMCommentEntityData, topic: string): Promise<AXMConversationRoom | null>;
-    listRoomsForEntity(entityRef: AXMCommentEntityData): Promise<AXMConversationRoom[]>;
-    listThreads(entityRef: AXMCommentEntityData, topic: string): Promise<AXMConversationRoom[]>;
+    createThread(creatorUser: AXPUserReference, entityRef: AXMCommentEntityData$1, topic: string, title?: string): Promise<AXMConversationRoom>;
+    getThread(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMConversationRoom | null>;
+    listRoomsForEntity(entityRef: AXMCommentEntityData$1): Promise<AXMConversationRoom[]>;
+    listThreads(entityRef: AXMCommentEntityData$1, topic: string): Promise<AXMConversationRoom[]>;
     updateThread(threadId: string, data: Partial<{
         title: string;
     }>): Promise<AXMConversationRoom>;
@@ -1561,64 +1795,6 @@ declare class AXMCommentWidgetViewComponent extends AXPValueWidgetComponent<AXPE
 
 declare const AXPCommentWidget: AXPWidgetConfig;
 
-/** Entity reference an entity-scoped chat is bound to (stored in conversation metadata). */
-interface AXMEntityChatRef {
-    entityId: string;
-    entityType: string;
-}
-/** Room fields used to decide whether a chat belongs on the main inbox. */
-interface AXMEntityChatRoomRef {
-    metadata?: Record<string, unknown>;
-    entityRef?: Pick<AXMCommentEntityData$1, 'entityId' | 'entityTypeId'> | null;
-}
-/** Room metadata flag: entity mini-chats stay off `/chat/`; header inbox chats omit this. */
-declare const AXM_MINI_CHAT_SCOPE_METADATA_KEY = "miniChatScope";
-declare const AXM_MINI_CHAT_SCOPE_ENTITY = "entity";
-/**
- * Synthetic record id for Ask AI on an entity **list** (no row id).
- * Keeps list history on that page and out of the main chat sidebar.
- */
-declare const AXM_ENTITY_LIST_CHAT_ID = "__entity-list__";
-/**
- * Conversation metadata for an entity-scoped assist chat.
- * Keeps `assistId` so the existing assist reply pipeline still answers in entity chats.
- */
-declare function axmBuildEntityChatConversationMetadata(args: {
-    entityId: string;
-    entityType: string;
-    assistId: string;
-}): Record<string, unknown>;
-/**
- * `AXConversationService.createConversation` stores the whole UI options object as
- * `room.metadata`, nesting real keys under `metadata.metadata`. Flatten so entity
- * flags sit at the top level for inbox filters and `entityRef`.
- */
-declare function axmFlattenConversationCreateMetadata(metadata: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
-/**
- * Resolves the entity reference from conversation metadata.
- * `AXConversationService.createConversation` may nest the UI object, so values
- * are also probed at `metadata.metadata.*`.
- */
-declare function axmExtractEntityRefFromMetadata(metadata: Record<string, unknown> | undefined): AXMEntityChatRef | undefined;
-/** Entity id/type from a contextual-assist launch payload (entity row / details). */
-declare function axmEntityRefFromLaunchContext(launch: AXMContextualAssistContext | undefined): AXMEntityChatRef | undefined;
-/** True when the conversation is bound to an entity page (not the site-header inbox). */
-declare function axmConversationIsEntityChat(metadata: Record<string, unknown> | undefined): boolean;
-/** True when conversation metadata targets the given entity reference. */
-declare function axmConversationMatchesEntity(metadata: Record<string, unknown> | undefined, ref: AXMEntityChatRef): boolean;
-/**
- * True when a persisted room is an entity-scoped chat (metadata and/or `entityRef`).
- * Header / inbox AI chats have neither; they belong on `/chat/`.
- */
-declare function axmRoomIsEntityChat(room: AXMEntityChatRoomRef | null | undefined): boolean;
-/** True when a room is bound to the given entity via metadata or `entityRef`. */
-declare function axmRoomMatchesEntity(room: AXMEntityChatRoomRef | null | undefined, ref: AXMEntityChatRef): boolean;
-/**
- * Persisted `entityRef` for an entity-scoped chat room so history can query by record
- * and the main inbox can exclude the room (comment threads use `kind: 'comment'`).
- */
-declare function axmBuildEntityChatRoomEntityRef(metadata: Record<string, unknown> | undefined): AXMCommentEntityData$1 | undefined;
-
 /** Arguments accepted by `AXConversationService.createConversation`, prebuilt for an entity chat. */
 interface AXMEntityChatCreateData {
     participantIds: string[];
@@ -1651,6 +1827,8 @@ declare class AXMEntityChatService {
     private get conversationApi();
     /** Returns every conversation bound to the given entity reference. */
     findEntityConversations(ref: AXMEntityChatRef): Promise<AXConversation[]>;
+    /** History for one mini-chat surface: global, an entity or record, or a launch such as form designer. */
+    findHistoryConversations(scope: AXMMiniChatHistoryScope): Promise<AXConversation[]>;
     /**
      * Creates a new entity-scoped assist conversation and selects it.
      * Must go through {@link AXConversationService.createConversation} so the open mini-chat
@@ -1674,19 +1852,23 @@ declare class AXMEntityChatService {
  * Compact scrollable list of inbox AI-assist chats (non-entity bot / assist conversations).
  */
 declare class AXMMiniChatInboxHistoryComponent implements OnInit {
-    private readonly conversationApi;
+    private readonly entityChatService;
     private readonly conversationFilter;
     private readonly realtimeBus;
     private readonly destroyRef;
+    /** Which chats to list. Defaults to global (no entity and no surface). */
+    readonly scope: _angular_core.InputSignal<AXMMiniChatHistoryScope>;
     /** Emits when the user picks a conversation from the list. */
     readonly conversationSelected: _angular_core.OutputEmitterRef<string>;
     /** Emits whether the loaded history contains at least one conversation. */
     readonly hasConversationsChange: _angular_core.OutputEmitterRef<boolean>;
     readonly conversations: _angular_core.WritableSignal<AXConversation[]>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private refreshGeneration;
+    constructor();
     ngOnInit(): void;
-    /** Reloads AI-assist inbox conversations. */
-    refresh(): Promise<void>;
+    /** Reloads conversations for the current history scope. */
+    refresh(scope?: AXMMiniChatHistoryScope): Promise<void>;
     private bindRealtimeHistory;
     private matchesInbox;
     protected resolveListAvatar(conversation: AXConversation): {
@@ -1696,7 +1878,7 @@ declare class AXMMiniChatInboxHistoryComponent implements OnInit {
     };
     protected onSelect(conversationId: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMMiniChatInboxHistoryComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatInboxHistoryComponent, "axm-mini-chat-inbox-history", never, {}, { "conversationSelected": "conversationSelected"; "hasConversationsChange": "hasConversationsChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatInboxHistoryComponent, "axm-mini-chat-inbox-history", never, { "scope": { "alias": "scope"; "required": false; "isSignal": true; }; }, { "conversationSelected": "conversationSelected"; "hasConversationsChange": "hasConversationsChange"; }, never, never, true, never>;
 }
 
 type AXMMiniChatInboxConversationFilter = (conversation: AXConversation) => boolean;
@@ -1826,9 +2008,11 @@ declare class AXMMiniChatHistoryComponent implements OnInit {
     readonly hasConversationsChange: _angular_core.OutputEmitterRef<boolean>;
     readonly conversations: _angular_core.WritableSignal<AXConversation[]>;
     readonly loading: _angular_core.WritableSignal<boolean>;
+    private refreshGeneration;
+    constructor();
     ngOnInit(): void;
     /** Reloads the entity conversation list (call when the history panel becomes visible). */
-    refresh(): Promise<void>;
+    refresh(entityId?: string, entityType?: string): Promise<void>;
     private bindRealtimeHistory;
     protected resolveListAvatar(conversation: AXConversation): {
         title: string;
@@ -1845,118 +2029,52 @@ declare function axmUpsertMiniChatHistoryItem(items: AXConversation[], next: AXC
 /** Removes a conversation from a mini-chat history list. */
 declare function axmRemoveMiniChatHistoryItem(items: AXConversation[], conversationId: string): AXConversation[];
 
-/** Anchor element for overlay positioning. */
-type AXMMiniChatPanelAnchor = Element | ElementRef<HTMLElement>;
-/**
- * Common placement aliases mapped to {@link AXPlacement}.
- * Examples: `top-right` → `top-end`, `bottom-left` → `bottom-start`.
- */
-type AXMMiniChatPanelSide = AXPlacement | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left' | 'right';
-/** Fixed viewport coordinates (px). Ignored when `anchor` is set. */
-interface AXMMiniChatPanelPosition {
-    x: number;
-    y: number;
-}
-/** Mini chat panel scope: entity-bound threads or main inbox (non-entity chats). */
-type AXMMiniChatPanelScope = 'entity' | 'inbox';
-/**
- * How the shared panel is hosted.
- * `overlay` is the floating window (header / entity pages).
- * `embedded` fills the host (entity record details, later).
- */
-type AXMMiniChatPanelPresentation = 'overlay' | 'embedded';
-/** Session key used for the global inbox mini chat (non-entity conversations). */
-declare const AXM_MINI_CHAT_INBOX_SESSION_KEY = "__inbox__";
-/** Popup dock name for minimized mini-chat tabs in the root footer. */
-declare const AXM_MINI_CHAT_POPUP_DOCK = "mini-chat";
-/** Persisted panel state for a mini chat session. */
-interface AXMMiniChatPanelSessionState {
-    view: 'thread' | 'history';
-    selectedChatId?: string;
-    hasOpened: boolean;
-}
-/** Options passed to {@link AXMMiniChatPanelService.open}. */
-interface AXMMiniChatPanelOpenOptions {
-    /** Default: `entity`. Use `inbox` for regular (non-entity) chats shown in the main chat sidebar. */
-    scope?: AXMMiniChatPanelScope;
-    entityId?: string;
-    entityType?: string;
-    assistId?: string;
-    title?: string;
-    showInfoBar?: boolean;
-    showComposer?: boolean;
-    /** Default: `overlay`. Use `embedded` when the panel is inlined in a page. */
-    presentation?: AXMMiniChatPanelPresentation;
-    /** Fixed viewport position (px). Ignored when `anchor` is set. */
-    position?: AXMMiniChatPanelPosition;
-    /** Anchor element for popover placement. */
-    anchor?: AXMMiniChatPanelAnchor;
-    /** Placement relative to anchor. Default: `top-end` when anchored. */
-    placement?: AXMMiniChatPanelSide;
-    offsetX?: number;
-    offsetY?: number;
-    autoFlip?: boolean;
-    /** When true, always opens a fresh conversation thread. */
-    forceNewChat?: boolean;
-    /**
-     * Record/surface context for a new assist thread (entity-row assist).
-     * Stored on the room and used to generate contextual starter chips.
-     */
-    launchContext?: AXMContextualAssistContext;
-}
-/** Window controls exposed by the mini-chat popup host to {@link AXMMiniChatPanelService}. */
-interface AXMMiniChatPopupWindowApi {
-    close(): void;
-    restore(): void;
-    minimize(): void;
-    maximize(): void;
-    isMinimized(): boolean;
-    isMaximized(): boolean;
-}
-/** Assigned onto {@link AXMMiniChatPopupWindowComponent} via popup `data`. */
-interface AXMMiniChatPopupWindowData {
-    scope: AXMMiniChatPanelScope;
-    entityId?: string;
-    entityType?: string;
-    assistId?: string;
-    panelTitle?: string;
-    showInfoBar: boolean;
-    showComposer: boolean;
-    initialView: 'thread' | 'history';
-    initialConversationId?: string;
-    startWithNewChat: boolean;
-    launchContext?: AXMContextualAssistContext;
-    onSessionChange?: (state: Pick<AXMMiniChatPanelSessionState, 'view' | 'selectedChatId'>) => void;
-    registerWindow?: (api: AXMMiniChatPopupWindowApi | null) => void;
-}
-
 /**
  * Opens the shared mini chat window via {@link AXPopupService} (header inbox, entity FAB, contextual assist).
  * Uses the module {@link AXConversationService} so assist SSE patches stream live.
- * Stays mounted across route changes; minimize hides the overlay and docks a tab in the footer.
+ * Stays mounted across route changes and returns to that page's home thread.
+ * Minimize hides the overlay and docks a tab in the footer.
  * Restores the last conversation per session on reopen; use {@link forceNewChat} for an explicit new thread.
  */
 declare class AXMMiniChatPanelService {
     private readonly popupService;
+    private readonly settingsService;
+    private readonly document;
     private readonly translation;
     private readonly conversationService;
     private readonly conversationApi;
     private readonly focusService;
+    private readonly router;
+    private readonly routeHome;
     private windowApi;
     private closePromise;
     private windowGeneration;
+    private anchorPlacementCleanup;
     /** Active conversation before the panel took over selection (entity scope; restored on close). */
     private savedActiveConversationId;
     /** Root focus id before the panel opened (restored so assist/realtime keep the right thread). */
     private savedFocusedConversationId;
     /** Per-entity session (view, selected conversation) restored when the panel reopens. */
     private readonly sessions;
-    /** Reactive open state for launcher UI (true while the window exists, including minimized). */
+    private retainOnClose;
+    private retainedHidden;
+    private retainedSessionKey;
+    private activeOpenOptions;
+    private boundRouteKey;
+    private activePageKey;
+    private retargeting;
+    private popupFrameReady;
+    /** Reactive open state for launcher UI (true while the window exists, including minimized or hidden). */
     readonly panelOpen: _angular_core.WritableSignal<boolean>;
-    /** True while the mini chat window is mounted (visible or minimized). */
+    constructor();
+    /** True while the mini chat window is mounted (visible, minimized, or retained-hidden). */
     isOpen(): boolean;
+    /** True while the window is on screen. */
+    isVisible(): boolean;
     /** Closes the window when it is open. */
     close(): void;
+    /** Hides a retained window. Destroys the window when retention is off. */
+    dismiss(): void;
     /** Toggles the inbox mini chat window (regular non-entity conversations). */
     toggleInbox(options?: Omit<AXMMiniChatPanelOpenOptions, 'scope' | 'entityId' | 'entityType'>): void;
     /**
@@ -1971,8 +2089,17 @@ declare class AXMMiniChatPanelService {
     private resolveWindowTitle;
     private buildSessionKey;
     private buildEntityKey;
+    /** List and record of the same entity are different chats. */
+    private currentPageChatKey;
     private abandonOpenWindow;
+    private onNavigation;
     private finishWindowClose;
+    /** Pins the popup beside its opener, or restores the last header-drag position. */
+    private watchAnchorPlacement;
+    private ensurePopupFrameLoaded;
+    private loadPopupFrame;
+    private persistPopupFrame;
+    private clearAnchorPlacement;
     private captureActiveConversation;
     private captureFocusedConversation;
     private restoreFocusedConversation;
@@ -2002,13 +2129,6 @@ declare class AXMMiniChatLauncherComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatLauncherComponent, "axm-mini-chat-launcher", never, { "entityId": { "alias": "entityId"; "required": true; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": true; "isSignal": true; }; "assistId": { "alias": "assistId"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "offsetX": { "alias": "offsetX"; "required": false; "isSignal": true; }; "offsetY": { "alias": "offsetY"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type AXMMiniChatContextChipKind = 'entity' | 'view' | 'record';
-interface AXMMiniChatContextChip {
-    id: string;
-    kind: AXMMiniChatContextChipKind;
-    label: string;
-}
-
 /**
  * Live entity/view/record chips for the header mini chat.
  * Chips stay editable until the first message pins them on the conversation.
@@ -2021,6 +2141,7 @@ declare class AXMMiniChatPageContextChipsService {
     private readonly translation;
     readonly chips: _angular_core.WritableSignal<AXMMiniChatContextChip[]>;
     readonly locked: _angular_core.WritableSignal<boolean>;
+    readonly historyScope: _angular_core.WritableSignal<AXMMiniChatHistoryScope>;
     private capturing;
     private pinnedId;
     private readonly dismissed;
@@ -2052,6 +2173,7 @@ declare class AXMMiniChatPageContextChipsService {
     private ensureDetailDraft;
     private fetchDetail;
     private applyDraft;
+    private publishHistoryScope;
     private readDetailRoute;
     private readRecordTitle;
     private resolveText;
@@ -2065,18 +2187,23 @@ declare class AXMMiniChatPageContextChipsService {
  */
 declare class AXMMiniChatPanelComponent implements OnInit, OnDestroy {
     private readonly conversationService;
+    private readonly composerService;
+    private readonly fileDrop;
+    private fileDragDepth;
     private readonly conversationApi;
     private readonly pageContext;
     private readonly localeService;
     private readonly device;
     private readonly destroyRef;
     protected readonly pageContextChips: AXMMiniChatPageContextChipsService;
+    private readonly routeHome;
     private readonly localeProfile;
     readonly scope: _angular_core.InputSignal<AXMMiniChatPanelScope>;
     readonly presentation: _angular_core.InputSignal<AXMMiniChatPanelPresentation>;
     readonly entityId: _angular_core.InputSignal<string | undefined>;
     readonly entityType: _angular_core.InputSignal<string | undefined>;
     readonly assistId: _angular_core.InputSignal<string | undefined>;
+    readonly assistSelection: _angular_core.InputSignal<AXMMiniChatAssistSelection>;
     readonly title: _angular_core.InputSignal<string | undefined>;
     readonly showInfoBar: _angular_core.InputSignal<boolean>;
     readonly showComposer: _angular_core.InputSignal<boolean>;
@@ -2092,13 +2219,16 @@ declare class AXMMiniChatPanelComponent implements OnInit, OnDestroy {
     readonly onSessionChange: _angular_core.InputSignal<((state: Pick<AXMMiniChatPanelSessionState, "view" | "selectedChatId">) => void) | undefined>;
     protected readonly view: _angular_core.WritableSignal<"thread" | "history">;
     protected readonly selectedChatId: _angular_core.WritableSignal<string | undefined>;
-    protected readonly isInboxScope: _angular_core.Signal<boolean>;
+    protected readonly fileDragOver: _angular_core.WritableSignal<boolean>;
+    protected readonly historyScope: _angular_core.Signal<AXMMiniChatHistoryScope>;
     protected readonly isEmbedded: _angular_core.Signal<boolean>;
     protected readonly isRtl: _angular_core.Signal<boolean>;
     protected readonly canDragWindow: _angular_core.Signal<boolean>;
     protected readonly canMinimize: _angular_core.Signal<boolean>;
     protected readonly canMaximize: _angular_core.Signal<boolean>;
     protected readonly canClose: _angular_core.Signal<boolean>;
+    /** Home is already a new chat; the plus action is for history and open threads. */
+    protected readonly showNewChatAction: _angular_core.Signal<boolean>;
     protected readonly isRecordAssist: _angular_core.Signal<boolean>;
     protected readonly workingInEntityTitle: _angular_core.Signal<string | null>;
     protected readonly workingInViewTitle: _angular_core.Signal<string | null>;
@@ -2111,6 +2241,11 @@ declare class AXMMiniChatPanelComponent implements OnInit, OnDestroy {
     protected closePanel(): void;
     protected minimizePanel(): void;
     protected toggleMaximizePanel(): void;
+    protected onFileDragEnter(event: DragEvent): void;
+    protected onFileDragOver(event: DragEvent): void;
+    protected onFileDragLeave(event: DragEvent): void;
+    protected onFileDragEnd(): void;
+    protected onFileDrop(event: DragEvent): Promise<void>;
     protected backToThread(): void;
     protected openHistory(): void;
     protected selectChat(conversationId: string): void;
@@ -2121,9 +2256,12 @@ declare class AXMMiniChatPanelComponent implements OnInit, OnDestroy {
     private bindPageContextChips;
     private pinPageContextConversation;
     private readRecordTitle;
+    private canAcceptFileDrop;
+    private isFileDrag;
+    private resetFileDrag;
     private syncSession;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMMiniChatPanelComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatPanelComponent, "axm-mini-chat-panel", never, { "scope": { "alias": "scope"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": false; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "assistId": { "alias": "assistId"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showInfoBar": { "alias": "showInfoBar"; "required": false; "isSignal": true; }; "showComposer": { "alias": "showComposer"; "required": false; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": true; "isSignal": true; }; "requestMinimize": { "alias": "requestMinimize"; "required": false; "isSignal": true; }; "requestMaximize": { "alias": "requestMaximize"; "required": false; "isSignal": true; }; "requestRestore": { "alias": "requestRestore"; "required": false; "isSignal": true; }; "isMaximized": { "alias": "isMaximized"; "required": false; "isSignal": true; }; "initialView": { "alias": "initialView"; "required": false; "isSignal": true; }; "initialConversationId": { "alias": "initialConversationId"; "required": false; "isSignal": true; }; "startWithNewChat": { "alias": "startWithNewChat"; "required": false; "isSignal": true; }; "launchContext": { "alias": "launchContext"; "required": false; "isSignal": true; }; "onSessionChange": { "alias": "onSessionChange"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatPanelComponent, "axm-mini-chat-panel", never, { "scope": { "alias": "scope"; "required": false; "isSignal": true; }; "presentation": { "alias": "presentation"; "required": false; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": false; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "assistId": { "alias": "assistId"; "required": false; "isSignal": true; }; "assistSelection": { "alias": "assistSelection"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showInfoBar": { "alias": "showInfoBar"; "required": false; "isSignal": true; }; "showComposer": { "alias": "showComposer"; "required": false; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": true; "isSignal": true; }; "requestMinimize": { "alias": "requestMinimize"; "required": false; "isSignal": true; }; "requestMaximize": { "alias": "requestMaximize"; "required": false; "isSignal": true; }; "requestRestore": { "alias": "requestRestore"; "required": false; "isSignal": true; }; "isMaximized": { "alias": "isMaximized"; "required": false; "isSignal": true; }; "initialView": { "alias": "initialView"; "required": false; "isSignal": true; }; "initialConversationId": { "alias": "initialConversationId"; "required": false; "isSignal": true; }; "startWithNewChat": { "alias": "startWithNewChat"; "required": false; "isSignal": true; }; "launchContext": { "alias": "launchContext"; "required": false; "isSignal": true; }; "onSessionChange": { "alias": "onSessionChange"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -2132,18 +2270,23 @@ declare class AXMMiniChatPanelComponent implements OnInit, OnDestroy {
  */
 declare class AXMMiniChatPopupWindowComponent extends AXPopupComponentBase {
     private readonly destroyRef;
+    private readonly hostElement;
     scope: AXMMiniChatPanelScope;
     entityId?: string;
     entityType?: string;
     assistId?: string;
+    assistSelection: AXMMiniChatAssistSelection;
     panelTitle?: string;
     showInfoBar: boolean;
     showComposer: boolean;
+    minimizable: boolean;
+    retainOnClose: boolean;
     initialView: 'thread' | 'history';
     initialConversationId?: string;
     startWithNewChat: boolean;
     launchContext?: AXMContextualAssistContext;
     onSessionChange?: (state: Pick<AXMMiniChatPanelSessionState, 'view' | 'selectedChatId'>) => void;
+    onVisibilityChange?: (visible: boolean) => void;
     registerWindow?: (api: AXMMiniChatPopupWindowApi | null) => void;
     protected readonly closeFn: () => void;
     protected readonly minimizeFn: () => void;
@@ -2151,10 +2294,37 @@ declare class AXMMiniChatPopupWindowComponent extends AXPopupComponentBase {
     protected readonly restoreFn: () => void;
     private readonly windowApi;
     constructor();
+    /**
+     * Escape uses the popup close path. A retained window stays mounted and only hides.
+     */
+    onClosing(event: {
+        cancel: boolean;
+    }): void;
+    private hideRetained;
+    private showRetained;
+    private overlayElement;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMMiniChatPopupWindowComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatPopupWindowComponent, "axm-mini-chat-popup-window", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Lets the mini-chat window add files to the empty-state composer
+ * the same way its attachment button does.
+ */
+declare class AXMMiniChatFileDropService {
+    private emptyDraftAdder;
+    private pendingEmptyDraft;
+    /** Compact empty composer registers while it is the visible new-chat surface. */
+    registerEmptyDraftAdder(add: (files: File[]) => void): () => void;
+    /**
+     * Adds files to the empty composer when it is mounted.
+     * Queues them when the thread is about to show that composer.
+     */
+    addEmptyDraftFiles(files: File[]): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMMiniChatFileDropService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMMiniChatFileDropService>;
+}
+
 /**
  * Root-footer dock for minimized mini-chat windows (`mini-chat` dock name).
  */
@@ -2188,6 +2358,8 @@ declare class AXMMiniChatComponent {
     readonly entityType: _angular_core.InputSignal<string | undefined>;
     /** Assist used as the bot peer when creating a new entity chat (falls back to the tenant default). */
     readonly assistId: _angular_core.InputSignal<string | undefined>;
+    /** `ask` prompts in the header inbox. `locked` hides the picker (form designer). */
+    readonly assistSelection: _angular_core.InputSignal<AXMMiniChatAssistSelection>;
     /** Surface context for a new assist thread (entity-row assist chips and room metadata). */
     readonly launchContext: _angular_core.InputSignal<AXMContextualAssistContext | undefined>;
     readonly showInfoBar: _angular_core.InputSignal<boolean>;
@@ -2204,7 +2376,7 @@ declare class AXMMiniChatComponent {
     /** Composer Stop — abort the in-flight assist stream for the active conversation. */
     onComposerGenerationCancelled(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMMiniChatComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatComponent, "axm-mini-chat", never, { "chatId": { "alias": "chatId"; "required": false; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": false; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "assistId": { "alias": "assistId"; "required": false; "isSignal": true; }; "launchContext": { "alias": "launchContext"; "required": false; "isSignal": true; }; "showInfoBar": { "alias": "showInfoBar"; "required": false; "isSignal": true; }; "showComposer": { "alias": "showComposer"; "required": false; "isSignal": true; }; }, { "conversationOpened": "conversationOpened"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMMiniChatComponent, "axm-mini-chat", never, { "chatId": { "alias": "chatId"; "required": false; "isSignal": true; }; "entityId": { "alias": "entityId"; "required": false; "isSignal": true; }; "entityType": { "alias": "entityType"; "required": false; "isSignal": true; }; "assistId": { "alias": "assistId"; "required": false; "isSignal": true; }; "assistSelection": { "alias": "assistSelection"; "required": false; "isSignal": true; }; "launchContext": { "alias": "launchContext"; "required": false; "isSignal": true; }; "showInfoBar": { "alias": "showInfoBar"; "required": false; "isSignal": true; }; "showComposer": { "alias": "showComposer"; "required": false; "isSignal": true; }; }, { "conversationOpened": "conversationOpened"; }, never, never, true, never>;
 }
 
 /** Fired after a user message is persisted — triggers assist, auto-reply, and realtime side effects. */
@@ -2226,5 +2398,5 @@ declare const CONVERSATION_START_DIRECT_CHAT_COMMAND = "Conversation:StartDirect
 /** Opens an existing conversation in the chat app. */
 declare const CONVERSATION_OPEN_CHAT_COMMAND = "Conversation:OpenChat";
 
-export { AXMAddReactionCommand, AXMAssistSuggestionChipsComponent, AXMChannelFeedItemComponent, AXMChannelFeedPage, AXMChatAnnouncementChannelService, AXMChatComponent, AXMChatComposerAssistPickerComponent, AXMChatComposerEnsureAssistConversationDirective, AXMChatConversationApi, AXMChatEmptyAssistSessionService, AXMChatEntityConversationApi, AXMChatEntityConversationFocusHandler, AXMChatEntityConversationRoomQueryService, AXMChatEntityMessageApi, AXMChatEntityRealtimeApi, AXMChatEntityUserApi, AXMChatMessageApi, AXMChatRealtimeApi, AXMChatUserApi, AXMCommentComponent, AXMCommentManagementService, AXMCommentPopupComponent, AXMCommentRealtimeService, AXMCommentRealtimeServiceImpl, AXMCommentService, AXMCommentServiceImpl, AXMCommentWidgetViewComponent, AXMConversationAssistBackgroundOperationHandler, AXMConversationEntityStoreService, AXMConversationFocusService, AXMConversationModule, AXMConversationRealtimeBus, AXMEntityChatService, AXMMiniChatComponent, AXMMiniChatFooterDockComponent, AXMMiniChatHeaderSlotComponent, AXMMiniChatHistoryComponent, AXMMiniChatInboxHistoryComponent, AXMMiniChatLauncherComponent, AXMMiniChatPageActionComponent, AXMMiniChatPanelComponent, AXMMiniChatPanelService, AXMMiniChatPopupWindowComponent, AXMShowCommentPopupCommand, AXM_AI_MANAGEMENT_AGENT_ENTITY_NAME, AXM_AI_MANAGEMENT_ASSIST_ENTITY_NAME, AXM_AI_MANAGEMENT_MODULE_NAME, AXM_ASSIST_DEFAULT_RESOLVER_PORT, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE, AXM_CHAT_ASSIST_CATALOG_PORT, AXM_CHAT_EMPTY_STATE_COMPONENT, AXM_CHAT_SIDEBAR_ACTION_PROVIDER, AXM_CONVERSATION_ASSIST_BACKGROUND_OPERATION_HANDLERS, AXM_CONVERSATION_ASSIST_BACKGROUND_OPERATION_KEY, AXM_CONVERSATION_ASSIST_RESPONSE_PORT, AXM_CONVERSATION_CHAT_ATTACHMENT_CATEGORY, AXM_CONVERSATION_CHAT_ATTACHMENT_REF_TYPE, AXM_CONVERSATION_REGULAR_AUTO_REPLY_PORT, AXM_CONVERSATION_TAB_BOT, AXM_ENTITY_LIST_CHAT_ID, AXM_MINI_CHAT_INBOX_CONVERSATION_FILTER, AXM_MINI_CHAT_INBOX_SESSION_KEY, AXM_MINI_CHAT_POPUP_DOCK, AXM_MINI_CHAT_SCOPE_ENTITY, AXM_MINI_CHAT_SCOPE_METADATA_KEY, AXPCommentWidget, COMMENTS_PAGE_COMPONENT_KEY, CONVERSATION_AFTER_MESSAGE_SENT_COMMAND, CONVERSATION_EMIT_TYPING_INDICATOR_COMMAND, CONVERSATION_MARK_CONVERSATION_UNREAD_COMMAND, CONVERSATION_OPEN_CHAT_COMMAND, CONVERSATION_RETRY_ASSIST_RESPONSE_COMMAND, CONVERSATION_SEND_ASSIST_CHAT_MESSAGE_COMMAND, CONVERSATION_START_ASSIST_CHAT_COMMAND, CONVERSATION_START_DIRECT_CHAT_COMMAND, CONVERSATION_SYNC_READ_STATE_COMMAND, axmApplyAnswerTextToAssistPayloadLine, axmAssistFollowUpItemsFromUnknown, axmAssistHasFinalizeMetadata, axmAssistLastTranscriptLine, axmAssistNormalizeFollowUpItemForConversation, axmAssistNormalizeFollowUpItemsForConversation, axmAssistPersistedMessageLooksComplete, axmAssistResolveFollowUpCommandName, axmAssistStarterPromptChipItems, axmAssistSuggestionIconForLabel, axmAssistUserFacingPayloadLine, axmAssistUserVisibleItemsForLine, axmAssistWidgetNodeDedupeKey, axmAssistWidgetNodeFromUnknown, axmBuildAiChatConversationMetadata, axmBuildAssistPeerParticipantFromCreateData, axmBuildAssistPeerParticipantFromId, axmBuildAssistTranscriptLinePayload, axmBuildAutoTitleFromUserText, axmBuildEntityChatConversationMetadata, axmBuildEntityChatRoomEntityRef, axmChatAiPeerParticipantId, axmChatAiTargetAvatarUrl, axmChatAiTargetDisplayDescription, axmChatAiTargetDisplayName, axmChatAiTargetShortcutDescriptionKey, axmChatRenderableAssistWidgetNode, axmCoerceDate, axmCoerceTimestampMs, axmComputeConversationUnreadCount, axmConversationHasAiChat, axmConversationIsEntityChat, axmConversationMatchesEntity, axmEntityRefFromLaunchContext, axmExcludeEntityChatConversations, axmExtractAssistIdFromMetadata, axmExtractAssistSnapshotFromMetadata, axmExtractDirectAgentIdFromMetadata, axmExtractEntityRefFromMetadata, axmExtractModelEntityIdFromMetadata, axmExtractTextFromPayload, axmFilterChatAiTargets, axmFlattenConversationCreateMetadata, axmHydrateRealtimeConversationMessage, axmInboxConversationTab, axmIsAssistBotConversation, axmIsAssistPeerParticipant, axmIsAssistResponseMessage, axmIsAssistRetryableStatus, axmIsAssistStreamingMessage, axmIsAssistStreamingStatus, axmIsAssistTerminalStatus, axmIsUnsupportedLegacyAgentAssistConversation, axmLoadChatAiTargets, axmMessageCountsTowardUnread, axmMessageEntityToMessage, axmNormalizeAssistTranscriptForChatUi, axmNormalizeAssistTranscriptLineResponses, axmParseAssistTranscriptLinePayload, axmParseAssistTranscriptTextEnvelope, axmPartitionAssistAnswerText, axmPreferLocalUnreadCount, axmReadAssistAiTranscript, axmReadAssistAiTranscriptRaw, axmReadAssistFollowUpStatus, axmReadAssistResponseError, axmReadAssistResponseStatus, axmReadPlainTextMessagePayload, axmReadReplyToUserMessageId, axmRemoveMiniChatHistoryItem, axmResolveAssistFinalAnswerText, axmResolveChatAiTargetText, axmRoomEntityToConversation, axmRoomIsEntityChat, axmRoomMatchesEntity, axmRoomWithAssistPeerDisplayName, axmSanitizeAssistUserAnswerText, axmShouldPreferPersistedAssistOverLiveCache, axmShowCommentPopupCommandDefinition, axmSortMessagesNewestFirst, axmSyncAssistPeerDisplayName, axmSyntheticEmbedMessage, axmUpsertMiniChatHistoryItem, axmUserRowToParticipant, channelFeedPageRoutes, commentsPlugin, createConversationServiceSessionAdapter, persistChatAttachment };
-export type { AXMAddReactionCommandInput, AXMAssistConversationSnapshotLite, AXMAssistDefaultResolverPort, AXMAssistStarterPromptChipOptions, AXMChatAiTargetRow, AXMChatAssistCatalogPort, AXMChatEmptyAssistContinue, AXMChatEmptyAssistCreatedHandler, AXMChatEmptyAssistSessionBind, AXMChatSidebarAction, AXMComment, AXMCommentEvent, AXMCommentEventType, AXMCommentThread, AXMConversationAssistResponsePort, AXMConversationRegularAutoReplyPort, AXMConversationServiceSessionAdapter, AXMEntityChatCreateData, AXMEntityChatRef, AXMEntityChatRoomRef, AXMMiniChatInboxConversationFilter, AXMMiniChatPanelAnchor, AXMMiniChatPanelOpenOptions, AXMMiniChatPanelPosition, AXMMiniChatPanelPresentation, AXMMiniChatPanelScope, AXMMiniChatPanelSessionState, AXMMiniChatPanelSide, AXMMiniChatPopupWindowApi, AXMMiniChatPopupWindowData, AXMSendAssistChatMessageOptions, AXMShowCommentPopupCommandInput, AXMThreadEvent, AXMThreadEventType, AXPAiChatFollowUpCommandLite, AXPAiChatFollowUpItemLite, AXPAiChatMessageLite, AXPAiChatNodeOrFollowUpResponseLite, AXPAiChatTextResponseLite, AXPAiEffectiveAssistRowLite, AxmAssistFollowUpStatus, AxmAssistPartitionedAnswerText, AxmAssistResponseStatus, AxmAssistTranscriptLinePayload, AxmAssistUserVisibleItem, CommentsDisplayMode, CommentsPluginOptions };
+export { AXMAddReactionCommand, AXMAssistSuggestionChipsComponent, AXMChannelFeedItemComponent, AXMChannelFeedPage, AXMChatAnnouncementChannelService, AXMChatComponent, AXMChatComposerAssistPickerComponent, AXMChatComposerEnsureAssistConversationDirective, AXMChatConversationApi, AXMChatEmptyAssistSessionService, AXMChatEntityConversationApi, AXMChatEntityConversationFocusHandler, AXMChatEntityConversationRoomQueryService, AXMChatEntityMessageApi, AXMChatEntityRealtimeApi, AXMChatEntityUserApi, AXMChatMessageApi, AXMChatRealtimeApi, AXMChatUserApi, AXMCommentComponent, AXMCommentManagementService, AXMCommentPopupComponent, AXMCommentRealtimeService, AXMCommentRealtimeServiceImpl, AXMCommentService, AXMCommentServiceImpl, AXMCommentWidgetViewComponent, AXMConversationAssistBackgroundOperationHandler, AXMConversationEntityStoreService, AXMConversationFocusService, AXMConversationModule, AXMConversationRealtimeBus, AXMEntityChatService, AXMMiniChatComponent, AXMMiniChatFileDropService, AXMMiniChatFooterDockComponent, AXMMiniChatHeaderSlotComponent, AXMMiniChatHistoryComponent, AXMMiniChatInboxHistoryComponent, AXMMiniChatLauncherComponent, AXMMiniChatPageActionComponent, AXMMiniChatPanelComponent, AXMMiniChatPanelService, AXMMiniChatPopupWindowComponent, AXMShowCommentPopupCommand, AXM_AI_MANAGEMENT_AGENT_ENTITY_NAME, AXM_AI_MANAGEMENT_ASSIST_ENTITY_NAME, AXM_AI_MANAGEMENT_MODULE_NAME, AXM_ASSIST_DEFAULT_RESOLVER_PORT, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE, AXM_CHAT_ASSIST_CATALOG_PORT, AXM_CHAT_EMPTY_STATE_COMPONENT, AXM_CHAT_SIDEBAR_ACTION_PROVIDER, AXM_CONVERSATION_ASSIST_BACKGROUND_OPERATION_HANDLERS, AXM_CONVERSATION_ASSIST_BACKGROUND_OPERATION_KEY, AXM_CONVERSATION_ASSIST_RESPONSE_PORT, AXM_CONVERSATION_CHAT_ATTACHMENT_CATEGORY, AXM_CONVERSATION_CHAT_ATTACHMENT_REF_TYPE, AXM_CONVERSATION_REGULAR_AUTO_REPLY_PORT, AXM_CONVERSATION_TAB_BOT, AXM_ENTITY_LIST_CHAT_ID, AXM_MINI_CHAT_INBOX_CONVERSATION_FILTER, AXM_MINI_CHAT_INBOX_SESSION_KEY, AXM_MINI_CHAT_POPUP_DOCK, AXM_MINI_CHAT_SCOPE_ENTITY, AXM_MINI_CHAT_SCOPE_METADATA_KEY, AXPCommentWidget, COMMENTS_PAGE_COMPONENT_KEY, CONVERSATION_AFTER_MESSAGE_SENT_COMMAND, CONVERSATION_EMIT_TYPING_INDICATOR_COMMAND, CONVERSATION_MARK_CONVERSATION_UNREAD_COMMAND, CONVERSATION_OPEN_CHAT_COMMAND, CONVERSATION_RETRY_ASSIST_RESPONSE_COMMAND, CONVERSATION_SEND_ASSIST_CHAT_MESSAGE_COMMAND, CONVERSATION_START_ASSIST_CHAT_COMMAND, CONVERSATION_START_DIRECT_CHAT_COMMAND, CONVERSATION_SYNC_READ_STATE_COMMAND, axmApplyAnswerTextToAssistPayloadLine, axmAssistFollowUpItemsFromUnknown, axmAssistHasFinalizeMetadata, axmAssistLastTranscriptLine, axmAssistNormalizeFollowUpItemForConversation, axmAssistNormalizeFollowUpItemsForConversation, axmAssistPersistedMessageLooksComplete, axmAssistResolveFollowUpCommandName, axmAssistStarterPromptChipItems, axmAssistSuggestionIconForLabel, axmAssistUserFacingPayloadLine, axmAssistUserVisibleItemsForLine, axmAssistWidgetNodeDedupeKey, axmAssistWidgetNodeFromUnknown, axmBuildAiChatConversationMetadata, axmBuildAssistPeerParticipantFromCreateData, axmBuildAssistPeerParticipantFromId, axmBuildAssistTranscriptLinePayload, axmBuildAutoTitleFromUserText, axmBuildEntityChatConversationMetadata, axmBuildEntityChatRoomEntityRef, axmChatAiPeerParticipantId, axmChatAiTargetAvatarUrl, axmChatAiTargetDisplayDescription, axmChatAiTargetDisplayName, axmChatAiTargetShortcutDescriptionKey, axmChatRenderableAssistWidgetNode, axmCoerceDate, axmCoerceTimestampMs, axmComputeConversationUnreadCount, axmConversationHasAiChat, axmConversationIsEntityChat, axmConversationIsGlobalChat, axmConversationMatchesEntity, axmConversationMatchesHistoryScope, axmEntityRefForMiniChatPageContext, axmEntityRefFromLaunchContext, axmExcludeEntityChatConversations, axmExtractAssistIdFromMetadata, axmExtractAssistSnapshotFromMetadata, axmExtractDirectAgentIdFromMetadata, axmExtractEntityRefFromMetadata, axmExtractModelEntityIdFromMetadata, axmExtractTextFromPayload, axmFilterChatAiTargets, axmFlattenConversationCreateMetadata, axmHydrateRealtimeConversationMessage, axmInboxConversationTab, axmIsAssistBotConversation, axmIsAssistPeerParticipant, axmIsAssistResponseMessage, axmIsAssistRetryableStatus, axmIsAssistStreamingMessage, axmIsAssistStreamingStatus, axmIsAssistTerminalStatus, axmIsUnsupportedLegacyAgentAssistConversation, axmLoadChatAiTargets, axmMessageCountsTowardUnread, axmMessageEntityToMessage, axmMiniChatHistoryScopeFromDraft, axmMiniChatHistoryScopeFromOpen, axmMiniChatHistoryScopeKey, axmMiniChatWindowOwnsRoute, axmNormalizeAssistTranscriptForChatUi, axmNormalizeAssistTranscriptLineResponses, axmParseAssistTranscriptLinePayload, axmParseAssistTranscriptTextEnvelope, axmPartitionAssistAnswerText, axmPreferLocalUnreadCount, axmReadAssistAiTranscript, axmReadAssistAiTranscriptRaw, axmReadAssistFollowUpStatus, axmReadAssistResponseError, axmReadAssistResponseStatus, axmReadPlainTextMessagePayload, axmReadReplyToUserMessageId, axmRemoveMiniChatHistoryItem, axmResolveAssistFinalAnswerText, axmResolveChatAiTargetText, axmRoomEntityToConversation, axmRoomIsEntityChat, axmRoomLaunchContext, axmRoomMatchesEntity, axmRoomWithAssistPeerDisplayName, axmSanitizeAssistUserAnswerText, axmShouldPreferPersistedAssistOverLiveCache, axmShowCommentPopupCommandDefinition, axmSortMessagesNewestFirst, axmSyncAssistPeerDisplayName, axmSyntheticEmbedMessage, axmUpsertMiniChatHistoryItem, axmUserRowToParticipant, channelFeedPageRoutes, commentsPlugin, createConversationServiceSessionAdapter, persistChatAttachment };
+export type { AXMAddReactionCommandInput, AXMAssistConversationSnapshotLite, AXMAssistDefaultResolverPort, AXMAssistStarterPromptChipOptions, AXMChatAiTargetRow, AXMChatAssistCatalogPort, AXMChatEmptyAssistContinue, AXMChatEmptyAssistCreatedHandler, AXMChatEmptyAssistSessionBind, AXMChatSidebarAction, AXMComment, AXMCommentEvent, AXMCommentEventType, AXMCommentThread, AXMConversationAssistResponsePort, AXMConversationRegularAutoReplyPort, AXMConversationServiceSessionAdapter, AXMEntityChatCreateData, AXMEntityChatRef, AXMEntityChatRoomRef, AXMMiniChatAssistSelection, AXMMiniChatHistoryScope, AXMMiniChatInboxConversationFilter, AXMMiniChatPanelAnchor, AXMMiniChatPanelOpenOptions, AXMMiniChatPanelPosition, AXMMiniChatPanelPresentation, AXMMiniChatPanelScope, AXMMiniChatPanelSessionState, AXMMiniChatPanelSide, AXMMiniChatPopupWindowApi, AXMMiniChatPopupWindowData, AXMSendAssistChatMessageOptions, AXMShowCommentPopupCommandInput, AXMThreadEvent, AXMThreadEventType, AXPAiChatFollowUpCommandLite, AXPAiChatFollowUpItemLite, AXPAiChatMessageLite, AXPAiChatNodeOrFollowUpResponseLite, AXPAiChatTextResponseLite, AXPAiEffectiveAssistRowLite, AxmAssistFollowUpStatus, AxmAssistPartitionedAnswerText, AxmAssistResponseStatus, AxmAssistTranscriptLinePayload, AxmAssistUserVisibleItem, CommentsDisplayMode, CommentsPluginOptions };