max-agent-ui 0.0.18 → 0.0.20

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, OnInit, DestroyRef } from '@angular/core';
+import { InjectionToken, OnInit, EventEmitter, DestroyRef } from '@angular/core';
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 
@@ -32,16 +32,23 @@ interface AssistantStructuredAction {
     capabilityKey: string;
     arguments: AssistantFieldMap;
 }
+interface AssistantHostAction {
+    type: string;
+    payload: AssistantFieldMap;
+}
 interface AssistantConversationMessage {
     role: 'user' | 'assistant';
     content: string;
     capabilityKey?: string;
 }
-type AssistantSuggestion = string | {
+interface AssistantSuggestionOption {
     label: string;
     message: string;
+    presentation?: 'capability_card';
+    section?: string;
     structuredAction?: AssistantStructuredAction;
-};
+}
+type AssistantSuggestion = string | AssistantSuggestionOption;
 interface AssistantPendingAction {
     id: number;
     summary: string;
@@ -152,11 +159,20 @@ interface AssistantDisplayResponse {
     sampleJsonResponse?: AssistantFieldValue | AssistantFieldMap;
     grid?: AssistantResponseTable[];
     tables?: AssistantResponseTable[];
+    searchResults?: AssistantSearchResult[];
     visualisations?: AssistantVisualisation[];
     shiftCardGroups?: AssistantShiftCardGroup[];
     rota?: AssistantRotaCalendar;
     markdown?: string;
 }
+interface AssistantSearchResult {
+    title: string;
+    type: string;
+    actions: Array<{
+        label: string;
+        hostAction: AssistantHostAction;
+    }>;
+}
 interface AssistantVisualisation {
     type: 'doughnut' | 'bar';
     title: string;
@@ -218,9 +234,54 @@ interface AssistantResponseTableAction {
 }
 interface AssistantUser {
     [key: string]: AssistantFieldValue | undefined;
+    name?: string;
+    username?: string;
+    email?: string;
+    phone?: string;
     token?: string;
     version?: string;
 }
+type AssistantSupportTicketSeverity = 'low' | 'medium' | 'high' | 'critical';
+type AssistantSupportTagSeverity = 'success' | 'secondary' | 'info' | 'warn' | 'danger' | 'contrast';
+interface AssistantSupportTag {
+    value: string;
+    label: string;
+    icon: string;
+    severity: AssistantSupportTagSeverity;
+}
+interface AssistantSupportTicketRequest {
+    name: string;
+    email: string;
+    phone?: string;
+    query: string;
+    severity: AssistantSupportTicketSeverity;
+    tags: string[];
+    app: AssistantProduct;
+}
+interface AssistantSupportTicketResponse {
+    success: boolean;
+    ticketReference: string;
+    message: string;
+    submittedAt: string;
+}
+type AssistantFeedbackCategory = 'incorrect' | 'incomplete' | 'unclear' | 'unexpected' | 'suggestion' | 'other';
+interface AssistantFeedbackRequest {
+    name: string;
+    email: string;
+    phone?: string;
+    category: AssistantFeedbackCategory;
+    query: string;
+    assistantResponse?: string;
+    feedback: string;
+    app: AssistantProduct;
+    conversationId?: string;
+}
+interface AssistantFeedbackResponse {
+    success: boolean;
+    feedbackReference: string;
+    message: string;
+    submittedAt: string;
+}
 interface AssistantChatRequest {
     message: string;
     stream?: boolean;
@@ -342,25 +403,70 @@ declare class MaxAssistantService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaxAssistantService>;
 }
 
+declare class MaxAssistantFeedbackService {
+    readonly endpoint = "/agent-api/v1/feedback";
+    readonly method: "POST";
+    submitFeedback(_feedback: AssistantFeedbackRequest): Observable<AssistantFeedbackResponse>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaxAssistantFeedbackService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaxAssistantFeedbackService>;
+}
+
+declare class MaxAssistantSupportService {
+    readonly tagsEndpoint = "selection/support-tags";
+    readonly ticketsEndpoint = "support/tickets";
+    getSupportTags(): Observable<AssistantSupportTag[]>;
+    submitTicket(_ticket: AssistantSupportTicketRequest): Observable<AssistantSupportTicketResponse>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaxAssistantSupportService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaxAssistantSupportService>;
+}
+
 declare const ASSISTANT_UI_COPY: {
     title: string;
     subtitle: string;
     clearLabel: string;
     clearTooltip: string;
+    closeLabel: string;
+    closeTooltip: string;
+    feedbackLabel: string;
+    feedbackTooltip: string;
     placeholder: string;
     startingMessage: string;
     errorMessage: string;
 };
+interface SupportTicketFormValue {
+    name: string;
+    email: string;
+    phone: string;
+    query: string;
+    severity: AssistantSupportTicketSeverity;
+    tags: string[];
+}
+interface FeedbackFormValue {
+    name: string;
+    email: string;
+    phone: string;
+    category: AssistantFeedbackCategory;
+    query: string;
+    assistantResponse: string;
+    feedback: string;
+}
 declare class MaxAssistantComponent implements OnInit {
     private readonly assistantService;
+    private readonly feedbackService;
+    private readonly supportService;
     private readonly destroyRef;
     private readonly defaultConfig;
     private messagesViewport?;
+    private composerInput?;
+    private supportQueryInput?;
+    private feedbackInput?;
     app?: AssistantProduct;
     assistantApiUrl?: string;
     user?: Partial<AssistantUser> | (() => Partial<AssistantUser>);
     context?: Partial<AssistantRequestContext> | (() => Partial<AssistantRequestContext>);
     requestHeaders?: Record<string, string> | (() => Record<string, string>);
+    hostAction: EventEmitter<AssistantHostAction>;
+    closeRequested: EventEmitter<void>;
     protected readonly isSending: _angular_core.WritableSignal<boolean>;
     protected readonly input: _angular_core.WritableSignal<string>;
     protected readonly conversationId: _angular_core.WritableSignal<string | undefined>;
@@ -368,8 +474,30 @@ declare class MaxAssistantComponent implements OnInit {
     protected readonly expandedDetailMessageIds: _angular_core.WritableSignal<ReadonlySet<string>>;
     protected readonly expandedTraceStepKeys: _angular_core.WritableSignal<ReadonlySet<string>>;
     protected readonly developerDetailsEnabled: boolean;
-    constructor(assistantService: MaxAssistantService, destroyRef: DestroyRef, defaultConfig: MaxAssistantConfig);
+    protected readonly feedbackVisible: _angular_core.WritableSignal<boolean>;
+    protected readonly feedbackSubmitting: _angular_core.WritableSignal<boolean>;
+    protected readonly feedbackResult: _angular_core.WritableSignal<AssistantFeedbackResponse | undefined>;
+    protected readonly feedbackError: _angular_core.WritableSignal<string | undefined>;
+    protected readonly feedbackCategoryOptions: Array<{
+        label: string;
+        value: AssistantFeedbackCategory;
+    }>;
+    protected feedbackForm: FeedbackFormValue;
+    protected readonly supportTicketVisible: _angular_core.WritableSignal<boolean>;
+    protected readonly supportTicketSubmitting: _angular_core.WritableSignal<boolean>;
+    protected readonly supportTagsLoading: _angular_core.WritableSignal<boolean>;
+    protected readonly supportTags: _angular_core.WritableSignal<AssistantSupportTag[]>;
+    protected readonly supportTicketResult: _angular_core.WritableSignal<AssistantSupportTicketResponse | undefined>;
+    protected readonly supportTicketError: _angular_core.WritableSignal<string | undefined>;
+    protected readonly supportSeverityOptions: Array<{
+        label: string;
+        value: AssistantSupportTicketSeverity;
+        severity: AssistantSupportTagSeverity;
+    }>;
+    protected supportTicketForm: SupportTicketFormValue;
+    constructor(assistantService: MaxAssistantService, feedbackService: MaxAssistantFeedbackService, supportService: MaxAssistantSupportService, destroyRef: DestroyRef, defaultConfig: MaxAssistantConfig);
     ngOnInit(): void;
+    focusComposer(): void;
     protected get uiCopy(): typeof ASSISTANT_UI_COPY;
     protected get bootstrapConfig(): AssistantBootstrapConfig;
     protected isWelcomeMessage(message: AssistantMessage): boolean;
@@ -378,7 +506,25 @@ declare class MaxAssistantComponent implements OnInit {
     protected clearChatSession(): void;
     protected sendMessage(message?: string): void;
     protected suggestionLabel(suggestion: AssistantSuggestion): string;
+    protected hasCapabilitySuggestions(suggestions?: AssistantSuggestion[]): boolean;
+    protected capabilitySuggestionGroups(suggestions?: AssistantSuggestion[]): Array<{
+        section: string;
+        options: AssistantSuggestionOption[];
+    }>;
     protected useSuggestion(suggestion: AssistantSuggestion): void;
+    protected performHostAction(action: AssistantHostAction): void;
+    protected requestClose(): void;
+    protected hasConversationStarted(): boolean;
+    protected openSupportTicket(): void;
+    protected closeSupportTicket(restoreComposerFocus?: boolean): void;
+    protected canSubmitSupportTicket(): boolean;
+    protected submitSupportTicket(): void;
+    protected openFeedback(responseMessage: AssistantMessage): void;
+    protected closeFeedback(restoreComposerFocus?: boolean): void;
+    protected canSubmitFeedback(): boolean;
+    protected submitFeedback(): void;
+    protected searchResultIcon(type: string): string;
+    protected searchActionIcon(action: AssistantSearchResult['actions'][number]): string;
     protected getTableRowActions(table: AssistantResponseTable, rowIndex: number): AssistantResponseTableAction[];
     protected useTableAction(action: AssistantResponseTableAction): void;
     protected resolvePendingAction(message: AssistantMessage, decision: AssistantConfirmation['decision']): void;
@@ -420,6 +566,11 @@ declare class MaxAssistantComponent implements OnInit {
     private replaceMessage;
     private createDefaultMessages;
     private getInitialMessage;
+    private getConfiguredUser;
+    private createSupportTicketForm;
+    private createFeedbackForm;
+    private getConversationPair;
+    private getUserText;
     private createAssistantResponseMessage;
     private createMessage;
     private createDisplayResponse;
@@ -440,7 +591,7 @@ declare class MaxAssistantComponent implements OnInit {
     private getConversationHistory;
     private scrollToLatest;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaxAssistantComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaxAssistantComponent, "max-assistant", never, { "app": { "alias": "app"; "required": false; }; "assistantApiUrl": { "alias": "assistantApiUrl"; "required": false; }; "user": { "alias": "user"; "required": false; }; "context": { "alias": "context"; "required": false; }; "requestHeaders": { "alias": "requestHeaders"; "required": false; }; }, {}, never, ["[maxAssistantHeaderAction]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaxAssistantComponent, "max-assistant", never, { "app": { "alias": "app"; "required": false; }; "assistantApiUrl": { "alias": "assistantApiUrl"; "required": false; }; "user": { "alias": "user"; "required": false; }; "context": { "alias": "context"; "required": false; }; "requestHeaders": { "alias": "requestHeaders"; "required": false; }; }, { "hostAction": "hostAction"; "closeRequested": "closeRequested"; }, never, never, true, never>;
 }
 
 type MaxAgentShiftCardVariant = 'definition' | 'rota';
@@ -457,5 +608,5 @@ declare class MaxAgentShiftCardComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MaxAgentShiftCardComponent, "max-agent-shift-card", never, { "shift": { "alias": "shift"; "required": true; }; "variant": { "alias": "variant"; "required": false; }; }, {}, never, never, true, never>;
 }
 
-export { MAX_ASSISTANT_CONFIG, MaxAgentShiftCardComponent, MaxAssistantComponent, MaxAssistantService };
-export type { AssistantApiCall, AssistantCard, AssistantChatProgress, AssistantChatRequest, AssistantChatResponse, AssistantChatStreamEvent, AssistantConfirmation, AssistantContextResolution, AssistantConversationMessage, AssistantDeveloperTrace, AssistantDisplayResponse, AssistantExtractedIntent, AssistantFieldMap, AssistantFieldValue, AssistantMessage, AssistantPendingAction, AssistantProduct, AssistantRequestContext, AssistantResponseTable, AssistantResponseTableAction, AssistantResponseTableColumn, AssistantRotaCalendar, AssistantShiftCard, AssistantShiftCardGroup, AssistantSource, AssistantStructuredAction, AssistantSuggestion, AssistantToolExecution, AssistantTraceControl, AssistantTraceStep, AssistantTraceStepCategory, AssistantTraceStepMetadata, AssistantTraceStepStatus, AssistantTraceTechnology, AssistantUser, AssistantVisualisation, MaxAgentShiftCardVariant, MaxAssistantConfig };
+export { MAX_ASSISTANT_CONFIG, MaxAgentShiftCardComponent, MaxAssistantComponent, MaxAssistantFeedbackService, MaxAssistantService, MaxAssistantSupportService };
+export type { AssistantApiCall, AssistantCard, AssistantChatProgress, AssistantChatRequest, AssistantChatResponse, AssistantChatStreamEvent, AssistantConfirmation, AssistantContextResolution, AssistantConversationMessage, AssistantDeveloperTrace, AssistantDisplayResponse, AssistantExtractedIntent, AssistantFeedbackCategory, AssistantFeedbackRequest, AssistantFeedbackResponse, AssistantFieldMap, AssistantFieldValue, AssistantHostAction, AssistantMessage, AssistantPendingAction, AssistantProduct, AssistantRequestContext, AssistantResponseTable, AssistantResponseTableAction, AssistantResponseTableColumn, AssistantRotaCalendar, AssistantSearchResult, AssistantShiftCard, AssistantShiftCardGroup, AssistantSource, AssistantStructuredAction, AssistantSuggestion, AssistantSuggestionOption, AssistantSupportTag, AssistantSupportTagSeverity, AssistantSupportTicketRequest, AssistantSupportTicketResponse, AssistantSupportTicketSeverity, AssistantToolExecution, AssistantTraceControl, AssistantTraceStep, AssistantTraceStepCategory, AssistantTraceStepMetadata, AssistantTraceStepStatus, AssistantTraceTechnology, AssistantUser, AssistantVisualisation, MaxAgentShiftCardVariant, MaxAssistantConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "max-agent-ui",
-  "version": "0.0.18",
+  "version": "0.0.20",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },