mesauth-angular 1.22.0 → 1.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mesauth-angular",
-  "version": "1.22.0",
+  "version": "1.24.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';
@@ -245,9 +245,18 @@ declare class MesAuthService {
 }
 
 /**
- * Functional HTTP interceptor for handling 401/403 auth errors.
- * Redirects to login page on 401, and to 403 page on 403.
- * Includes loopback prevention to avoid infinite redirects.
+ * Functional HTTP interceptor.
+ *
+ * Responsibilities:
+ *   1. Attach `Authorization: Bearer` + `X-Refresh-Token` from localStorage to requests
+ *      targeting the auth server / trusted hosts (so the server-side Authorizer middleware
+ *      can perform silent refresh and emit X-Refreshed-* response headers).
+ *   2. On every successful response, if `X-Refreshed-Token` is present, write it to
+ *      localStorage exactly once (dedup across parallel responses).
+ *   3. On 401, queue concurrent failures behind a single 1.5s wait so only ONE retry
+ *      fires per refresh window. Retries strip the stale auth headers so the interceptor
+ *      re-reads the freshly-stored tokens from localStorage.
+ *   4. On 403, redirect to /403.
  */
 declare const mesAuthInterceptor: HttpInterceptorFn;
 
@@ -303,6 +312,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 +340,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>;
@@ -612,6 +624,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';
@@ -697,6 +754,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>;
 }
@@ -710,6 +790,7 @@ 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;
@@ -737,6 +818,8 @@ declare class MaAiChatPanelComponent implements AfterViewInit, OnDestroy {
     close(): void;
     toggle(): void;
     newConversation(): void;
+    toggleHistory(): void;
+    onHistoryResumed(_id: string): void;
     send(): void;
     cancel(): void;
     onTextareaKey(ev: KeyboardEvent): void;
@@ -1057,7 +1140,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.24.0";
 /**
  * Provides server-driven UI configuration loaded from the hosted manifest.
  * Components read `labels()` and `features()` signals instead of hardcoded strings.
@@ -1282,6 +1365,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.
  *
@@ -1304,5 +1437,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, MaAiPanelMode, 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 };