mesauth-angular 1.21.0 → 1.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mesauth-angular",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "Angular helper library to connect to a backend API and SignalR hub to surface the current logged-in user and incoming notifications with dark/light theme support",
   "keywords": [
     "angular",

package/types/mesauth-angular.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, EnvironmentProviders, AfterViewInit, OnDestroy, ElementRef, PipeTransform } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, AfterViewInit, OnDestroy, ElementRef, OnInit, PipeTransform } from '@angular/core';
 import { HttpClient, HttpInterceptorFn, HttpResponse, HttpParams } from '@angular/common/http';
 import { Observable, OperatorFunction } from 'rxjs';
 import { Router } from '@angular/router';
@@ -303,6 +303,7 @@ declare class UserProfileComponent {
     readonly pendingApprovalCount: _angular_core.WritableSignal<number>;
     readonly dropdownOpen: _angular_core.WritableSignal<boolean>;
     readonly avatarRefresh: _angular_core.WritableSignal<number>;
+    readonly lessonsOpen: _angular_core.WritableSignal<boolean>;
     readonly navAvatarSize: _angular_core.Signal<AvatarSize>;
     readonly dropAvatarSize: _angular_core.Signal<AvatarSize>;
     readonly avatarShape: _angular_core.Signal<"circle" | "rounded" | "rectangle" | "portrait">;
@@ -330,6 +331,8 @@ declare class UserProfileComponent {
     private openInNewTabIfSameOrigin;
     onLogout(): void;
     onNotificationClick(): void;
+    openLessons(): void;
+    closeLessons(): void;
     onSigErr(_ev: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<UserProfileComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<UserProfileComponent, "ma-user-profile", never, { "inputAvatarShape": { "alias": "inputAvatarShape"; "required": false; "isSignal": true; }; "showBell": { "alias": "showBell"; "required": false; "isSignal": true; }; "showApproval": { "alias": "showApproval"; "required": false; "isSignal": true; }; "showName": { "alias": "showName"; "required": false; "isSignal": true; }; "showAi": { "alias": "showAi"; "required": false; "isSignal": true; }; "showSignature": { "alias": "showSignature"; "required": false; "isSignal": true; }; "signatureHeight": { "alias": "signatureHeight"; "required": false; "isSignal": true; }; }, { "notificationClick": "notificationClick"; "approvalClick": "approvalClick"; "aiClick": "aiClick"; }, never, ["*"], true, never>;
@@ -545,6 +548,7 @@ declare class MaApprovalPanelComponent {
     private readonly mesAuth;
     private readonly http;
     private readonly router;
+    private readonly host;
     private approvalSvc;
     constructor();
     open(): void;
@@ -611,6 +615,51 @@ interface ChatToolEvent {
     args?: any;
     readOnly?: boolean;
 }
+/** Summary row in the user's conversation history list. */
+interface AiConversationSummary {
+    id: string;
+    title: string | null;
+    appName: string | null;
+    originRoute: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+}
+/** One stored message from a past conversation (resume payload). */
+interface AiStoredMessage {
+    sequence: number;
+    role: 'user' | 'assistant' | 'tool' | string;
+    content: string | null;
+    toolCalls?: AiStoredToolCall[] | null;
+    toolCallId?: string | null;
+    toolIsError: boolean;
+    createdAt: string;
+}
+interface AiStoredToolCall {
+    id: string;
+    name: string;
+    args: any;
+    side: 'server' | 'client' | string;
+}
+/** Full transcript returned by GET /ai/conversations/{id}. */
+interface AiConversationDetail {
+    id: string;
+    title: string | null;
+    appName: string | null;
+    originRoute: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messages: AiStoredMessage[];
+}
+/** Per-user "lesson" injected into the system prompt every turn. */
+interface AiUserLesson {
+    id: string;
+    text: string;
+    enabled: boolean;
+    source: 'user' | 'llm' | string;
+    createdAt: string;
+    updatedAt: string;
+}
 /** Stream event types matching MesAuth.Api's AiStreamEvent JSON. */
 type AiSseEvent = {
     type: 'session';
@@ -696,6 +745,29 @@ declare class MaAiService {
     private verbOf;
     private summarize;
     private uid;
+    /** GET /ai/conversations — list this user's past conversations (most recent first). */
+    listConversations(take?: number): Promise<AiConversationSummary[]>;
+    /** GET /ai/conversations/{id} — fetch and hydrate a past conversation into the panel. */
+    resumeConversation(id: string): Promise<boolean>;
+    /** DELETE /ai/conversations/{id} */
+    deleteConversation(id: string): Promise<boolean>;
+    listLessons(): Promise<AiUserLesson[]>;
+    createLesson(text: string): Promise<AiUserLesson | null>;
+    updateLesson(id: string, patch: {
+        text?: string;
+        enabled?: boolean;
+    }): Promise<AiUserLesson | null>;
+    deleteLesson(id: string): Promise<boolean>;
+    private baseUrl;
+    private apiGet;
+    private apiSend;
+    /**
+     * Rebuild ChatBubble[] from a stored transcript. Tool messages don't appear as their
+     * own bubbles — they were emitted as chips on the preceding assistant bubble — but we
+     * reconstruct that linkage best-effort so the resumed view roughly matches what the
+     * user originally saw.
+     */
+    private hydrateBubbles;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaAiService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaAiService>;
 }
@@ -705,14 +777,17 @@ declare class MaAiService {
  * Uses panel-shared.css for the header/empty-state styling so it looks like the approval
  * and notification panels.
  */
-declare class MaAiChatPanelComponent implements AfterViewInit {
+declare class MaAiChatPanelComponent implements AfterViewInit, OnDestroy {
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     readonly width: _angular_core.WritableSignal<number>;
     readonly draft: _angular_core.WritableSignal<string>;
+    readonly historyOpen: _angular_core.WritableSignal<boolean>;
     readonly ai: MaAiService;
     private readonly router;
     private readonly themeService;
     private readonly uiConfig;
+    private readonly aiConfig;
+    private readonly panelMode;
     /** Suggested prompts shown in the empty state — manifest overridable. */
     readonly quickPrompts: _angular_core.Signal<string[]>;
     private readonly scrollContainer;
@@ -728,10 +803,14 @@ declare class MaAiChatPanelComponent implements AfterViewInit {
     private dragStartWidth;
     constructor();
     ngAfterViewInit(): void;
+    ngOnDestroy(): void;
+    private setLayoutVar;
     open(): void;
     close(): void;
     toggle(): void;
     newConversation(): void;
+    toggleHistory(): void;
+    onHistoryResumed(_id: string): void;
     send(): void;
     cancel(): void;
     onTextareaKey(ev: KeyboardEvent): void;
@@ -866,6 +945,7 @@ declare class NotificationPanelComponent {
     private readonly authService;
     private readonly toastService;
     private readonly themeService;
+    private readonly host;
     constructor();
     ngOnDestroy(): void;
     private loadNotifications;
@@ -1051,7 +1131,7 @@ interface MaUiManifest {
     quickPrompts?: string[];
 }
 /** Current installed package version — keep in sync with package.json. */
-declare const PACKAGE_VERSION = "1.21.0";
+declare const PACKAGE_VERSION = "1.23.0";
 /**
  * Provides server-driven UI configuration loaded from the hosted manifest.
  * Components read `labels()` and `features()` signals instead of hardcoded strings.
@@ -1182,6 +1262,7 @@ declare function runSsoCheckHandshake(authService: MesAuthService): Promise<void
  */
 declare function runReturnViaPostMessageIfRequested(authService: MesAuthService): Promise<boolean>;
 
+type MaAiPanelMode = 'static' | 'floating';
 interface MesAuthAiConfig {
     /** Master switch — when false the Ask-AI button hides and the panel never opens. */
     enabled?: boolean;
@@ -1200,6 +1281,18 @@ interface MesAuthAiConfig {
      * Optional friendly name of the host app; sent to the backend each turn.
      */
     appName?: string;
+    /**
+     * How the panel coexists with the host app layout.
+     *
+     * - `'static'` (default): the panel still renders as a fixed-position drawer, but the
+     *   library injects a global stylesheet that sets `padding-inline-end: var(--ma-ai-panel-width)`
+     *   on `<body>`. When the panel opens the host's `<body>` shrinks to make room, so wide
+     *   content reflows instead of being hidden under the drawer. Zero-config for the host —
+     *   no template or CSS changes required.
+     * - `'floating'`: legacy v1.21 behaviour. The panel overlays the host content at z-index 1040
+     *   without resizing the layout. Use this for hosts whose layout can't reflow safely.
+     */
+    panelMode?: MaAiPanelMode;
 }
 declare const MES_AUTH_AI_CONFIG: InjectionToken<MesAuthAiConfig>;
 /** Default configuration when the consumer doesn't call provideMesAuthAi(). */
@@ -1263,6 +1356,56 @@ declare class MaAiButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaAiButtonComponent, "ma-ai-button", never, {}, { "clicked": "clicked"; }, never, never, true, never>;
 }
 
+/**
+ * Drop-down list of the signed-in user's recent AI conversations.
+ * Lives inside the chat panel header (toggled by the History button).
+ */
+declare class MaAiHistoryListComponent implements OnInit {
+    private readonly ai;
+    readonly conversations: _angular_core.WritableSignal<AiConversationSummary[]>;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    /** Emitted after the user picks a row and the panel finishes hydrating. */
+    readonly resumed: _angular_core.OutputEmitterRef<string>;
+    ngOnInit(): void;
+    refresh(): Promise<void>;
+    pick(c: AiConversationSummary): Promise<void>;
+    remove(c: AiConversationSummary): Promise<void>;
+    relative(iso: string): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaAiHistoryListComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaAiHistoryListComponent, "ma-ai-history-list", never, {}, { "resumed": "resumed"; }, never, never, true, never>;
+}
+
+/**
+ * Modal editor for the signed-in user's AI "lessons" — long-lived instructions
+ * injected into the LLM system prompt every turn. Opened from the user profile
+ * dropdown via a dedicated button.
+ *
+ * Library-only styling (no @angular/forms — we use [value] + (input) per
+ * mesauth-angular conventions).
+ */
+declare class MaAiLessonsEditorComponent implements OnInit {
+    private readonly ai;
+    private readonly themeService;
+    readonly lessons: _angular_core.WritableSignal<AiUserLesson[]>;
+    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly saving: _angular_core.WritableSignal<boolean>;
+    readonly draft: _angular_core.WritableSignal<string>;
+    readonly error: _angular_core.WritableSignal<string>;
+    readonly cancel: _angular_core.OutputEmitterRef<void>;
+    private pendingText;
+    get themeClass(): string;
+    ngOnInit(): Promise<void>;
+    onBackdropClick(ev: MouseEvent): void;
+    onDraftInput(ev: Event): void;
+    add(): Promise<void>;
+    onTextInput(lesson: AiUserLesson, ev: Event): void;
+    commitText(lesson: AiUserLesson): Promise<void>;
+    toggle(lesson: AiUserLesson, ev: Event): Promise<void>;
+    remove(lesson: AiUserLesson): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaAiLessonsEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaAiLessonsEditorComponent, "ma-ai-lessons-editor", never, {}, { "cancel": "cancel"; }, never, never, true, never>;
+}
+
 /**
  * Tiny hand-rolled GitHub-flavoured Markdown renderer for AI chat bubbles.
  *
@@ -1285,5 +1428,5 @@ declare class MaAiMarkdownPipe implements PipeTransform {
 }
 declare function renderMarkdown(src: string): string;
 
-export { ALL_ACTIONS, AVATAR_FRAMES, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, DEFAULT_AI_CONFIG, MES_AUTH_AI_CONFIG, MES_AUTH_CONFIG, MaAiButtonComponent, MaAiChatPanelComponent, MaAiMarkdownPipe, MaAiService, MaAiToolsRegistry, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaAvatarComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MaUserMenuColor, MaUserMenuComponent, MaUserXComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, PACKAGE_VERSION, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, provideMesAuthAi, renderMarkdown, runReturnViaPostMessageIfRequested, runSsoCheckHandshake, withXMaPerm, xMaResource };
-export type { AiSseEvent, ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, AvatarFrameDef, AvatarShape, AvatarSize, ChatBubble, ChatToolEvent, ClientTool, ClientToolSchema, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaUiManifest, MesAuthAiConfig, MesAuthConfig, NotificationDto, PagedList, PendingApproval, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };
+export { ALL_ACTIONS, AVATAR_FRAMES, ApprovalActionType, ApprovalDocumentStatus, ApprovalStepMode, ApprovalStepStatus, DEFAULT_AI_CONFIG, MES_AUTH_AI_CONFIG, MES_AUTH_CONFIG, MaAiButtonComponent, MaAiChatPanelComponent, MaAiHistoryListComponent, MaAiLessonsEditorComponent, MaAiMarkdownPipe, MaAiService, MaAiToolsRegistry, MaApprovalPanelComponent, MaApprovalService, MaArvContainerComponent, MaAvatarComponent, MaIconComponent, MaThemeDirective, MaUiConfigService, MaUserComponent, MaUserMenuColor, MaUserMenuComponent, MaUserXComponent, MesAuthModule, MesAuthService, NotificationBadgeComponent, NotificationPanelComponent, NotificationType, PACKAGE_VERSION, ThemeService, ToastContainerComponent, ToastService, UserProfileComponent, extractXMaPerm, mesAuthInterceptor, provideMesAuth, provideMesAuthAi, renderMarkdown, runReturnViaPostMessageIfRequested, runSsoCheckHandshake, withXMaPerm, xMaResource };
+export type { AiConversationDetail, AiConversationSummary, AiSseEvent, AiStoredMessage, AiStoredToolCall, AiUserLesson, ApprovalDashboardDto, ApprovalDocumentDto, ApprovalDocumentSummaryDto, ApprovalHistoryDto, ApprovalReferenceDto, ApprovalStepDto, ApprovalStepRequest, ApprovalSubmitResult, ApprovalTemplateDto, ApprovalTemplateStepDto, ApprovalTemplateSummaryDto, ApproveRejectRequest, AvatarFrameDef, AvatarShape, AvatarSize, ChatBubble, ChatToolEvent, ClientTool, ClientToolSchema, CreateApprovalRequest, CreateApprovalResponseDto, CreateApprovalTemplateRequest, DelegateRequest, FrontEndRoute, IUser, MaAiPanelMode, MaUiManifest, MesAuthAiConfig, MesAuthConfig, NotificationDto, PagedList, PendingApproval, PermissionHeader, RealTimeNotificationDto, RequestConfig, RolePreviewUserDto, StepRoleDto, Theme, Toast, UpdateApprovalTemplateRequest, UserFrontEndRoutesGrouped };