max-agent-ui 0.0.36 → 0.0.38

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, OnInit, EventEmitter, DestroyRef } from '@angular/core';
+import { InjectionToken, OnInit, DoCheck, EventEmitter, DestroyRef } from '@angular/core';
 import { HttpClient } from '@angular/common/http';
 import { Observable } from 'rxjs';
 
@@ -30,7 +30,7 @@ interface AssistantConfirmation {
 }
 interface AssistantAnalyticsPage {
     offset: number;
-    pageSize: 250;
+    pageSize: 100;
 }
 interface AssistantStructuredAction {
     capabilityKey: string;
@@ -206,13 +206,26 @@ interface AssistantSearchResult {
         hostAction: AssistantHostAction;
     }>;
 }
+type AssistantVisualisationType = 'bar' | 'horizontalBar' | 'stackedBar' | 'doughnut' | 'pie' | 'line' | 'lineStyles' | 'radar' | 'polarArea' | 'barLine';
+interface AssistantVisualisationDataset {
+    label: string;
+    values: number[];
+    type?: 'bar' | 'line';
+    color?: string;
+    colors?: string[];
+    borderDash?: number[];
+    fill?: boolean;
+}
 interface AssistantVisualisation {
-    type: 'doughnut' | 'bar';
+    type: AssistantVisualisationType;
     title: string;
     labels: string[];
     values: number[];
     colors?: string[];
     valueLabel?: string;
+    datasets?: AssistantVisualisationDataset[];
+    xAxisLabel?: string;
+    yAxisLabel?: string;
 }
 interface AssistantShiftCard {
     id?: string | number;
@@ -262,7 +275,7 @@ interface AssistantResponseTable {
 interface AssistantResponseTablePagination {
     query: string;
     offset: number;
-    pageSize: 250;
+    pageSize: 100;
     totalRecords: number;
     totalRecordsExact?: boolean;
     returnedRecords: number;
@@ -331,6 +344,8 @@ interface AssistantFeedbackResponse {
     submittedAt: string;
 }
 interface AssistantChatRequest {
+    conversationStateVersion?: 1;
+    conversationState?: string;
     message: string;
     stream?: boolean;
     conversationId?: string;
@@ -344,17 +359,28 @@ interface AssistantChatRequest {
 }
 interface AssistantChatProgress {
     type: 'progress';
-    stage: 'request' | 'intent_projection' | 'embedding' | 'capability_routing' | 'argument_extraction' | 'api_call' | 'action' | 'response';
+    stage: 'request' | 'authorization' | 'intent_projection' | 'embedding' | 'capability_routing' | 'argument_extraction' | 'api_call' | 'action' | 'response';
     message: string;
 }
-type AssistantChatStreamEvent = AssistantChatProgress | {
+interface AssistantChatDelta {
+    type: 'delta';
+    delta: string;
+}
+interface AssistantChatData {
+    type: 'data';
+    data: Pick<AssistantChatResponse, 'displayResponse' | 'cards'>;
+}
+type AssistantChatActivity = AssistantChatProgress | AssistantChatDelta | AssistantChatData;
+type AssistantChatStreamEvent = AssistantChatActivity | {
     type: 'result';
     response: AssistantChatResponse;
 } | {
     type: 'error';
     message: string;
+    code?: string;
 };
 interface AssistantChatResponse {
+    conversationState?: string;
     answer: string;
     conversationId: string;
     product: string;
@@ -417,6 +443,8 @@ interface AssistantMessage {
     capabilityKey?: string;
     isError?: boolean;
     isStreaming?: boolean;
+    processingUpdates?: AssistantChatProgress[];
+    streamingContent?: string;
 }
 
 interface AssistantBootstrapConfig {
@@ -426,6 +454,9 @@ interface AssistantBootstrapConfig {
 }
 
 interface MaxAssistantConfig {
+    /** Per-request transient state supplied by the assistant, never persisted by the host. */
+    conversationStateVersion?: 1;
+    conversationState?: string;
     apiBaseUrl?: string;
     assistantApiUrl?: string;
     app?: AssistantProduct;
@@ -439,7 +470,7 @@ declare class MaxAssistantService {
     private readonly config;
     private readonly http;
     constructor(config: MaxAssistantConfig, http: HttpClient | null);
-    sendMessage(message: string, conversationId?: string, config?: MaxAssistantConfig, confirmation?: AssistantConfirmation, history?: AssistantConversationMessage[], onProgress?: (progress: AssistantChatProgress) => void): Observable<AssistantChatResponse>;
+    sendMessage(message: string, conversationId?: string, config?: MaxAssistantConfig, confirmation?: AssistantConfirmation, history?: AssistantConversationMessage[], onProgress?: (activity: AssistantChatActivity) => void): Observable<AssistantChatResponse>;
     confirmAction(actionId: number, decision: AssistantConfirmation['decision'], conversationId: string, config?: MaxAssistantConfig, history?: AssistantConversationMessage[]): Observable<AssistantChatResponse>;
     sendStructuredAction(message: string, action: AssistantStructuredAction, conversationId?: string, config?: MaxAssistantConfig, history?: AssistantConversationMessage[]): Observable<AssistantChatResponse>;
     retrieveAnalyticsPage(message: string, analyticsPage: AssistantAnalyticsPage, conversationId?: string, config?: MaxAssistantConfig, history?: AssistantConversationMessage[]): Observable<AssistantChatResponse>;
@@ -475,12 +506,9 @@ declare class MaxAssistantFeedbackService {
 
 declare class MaxAssistantExportService {
     exportTableToExcel(table: AssistantResponseTable): Promise<void>;
-    exportVisualisationToPdf(visualisation: AssistantVisualisation): Promise<void>;
-    private chartTotal;
+    exportVisualisationToPdf(visualisation: AssistantVisualisation, visualisationElement: HTMLElement): Promise<void>;
     private toExportCellValue;
     private exportFileName;
-    private fallbackColor;
-    private pdfColor;
     private downloadFile;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MaxAssistantExportService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MaxAssistantExportService>;
@@ -537,15 +565,19 @@ interface AssistantEntitySuggestionOption extends AssistantSuggestionOption {
     presentation: 'person_card' | 'entity_tag';
     entity: AssistantSuggestionEntity;
 }
-declare class MaxAssistantComponent implements OnInit {
+declare class MaxAssistantComponent implements OnInit, DoCheck {
     private readonly assistantService;
     private readonly exportService;
     private readonly feedbackService;
     private readonly supportService;
     private readonly destroyRef;
     private readonly defaultConfig;
+    private readonly sessionState;
     private messagesViewport?;
     private activeTurnAnchorMessageId?;
+    private scrollToLatestTimer?;
+    private readonly visualisationDataCache;
+    private readonly visualisationOptionsCache;
     private composerInput?;
     private supportQueryInput?;
     private feedbackInput?;
@@ -585,6 +617,9 @@ declare class MaxAssistantComponent implements OnInit {
     protected supportTicketForm: SupportTicketFormValue;
     constructor(assistantService: MaxAssistantService, exportService: MaxAssistantExportService, feedbackService: MaxAssistantFeedbackService, supportService: MaxAssistantSupportService, destroyRef: DestroyRef, defaultConfig: MaxAssistantConfig);
     ngOnInit(): void;
+    ngDoCheck(): void;
+    resetSession(): void;
+    protected onPageHide(): void;
     focusComposer(): void;
     protected get uiCopy(): typeof ASSISTANT_UI_COPY;
     protected get bootstrapConfig(): AssistantBootstrapConfig;
@@ -644,14 +679,18 @@ declare class MaxAssistantComponent implements OnInit {
     protected isTablePageLoading(messageId: string, tableIndex: number): boolean;
     protected tablePageError(messageId: string, tableIndex: number): string | undefined;
     protected exportTable(table: AssistantResponseTable): void;
-    protected exportVisualisation(visualisation: AssistantVisualisation): void;
-    protected chartTotal(visualisation: AssistantVisualisation): number;
-    protected chartColor(visualisation: AssistantVisualisation, index: number): string;
-    protected doughnutDashArray(visualisation: AssistantVisualisation, index: number): string;
-    protected doughnutDashOffset(visualisation: AssistantVisualisation, index: number): number;
-    protected barWidth(visualisation: AssistantVisualisation, index: number): number;
+    protected exportVisualisation(visualisation: AssistantVisualisation, visualisationElement: HTMLElement): void;
+    protected chartType(visualisation: AssistantVisualisation): 'bar' | 'line' | 'doughnut' | 'pie' | 'radar' | 'polarArea';
+    protected chartData(visualisation: AssistantVisualisation): {
+        labels: string[];
+        datasets: Array<Record<string, unknown>>;
+    };
+    protected chartOptions(visualisation: AssistantVisualisation): Record<string, unknown>;
+    protected chartHeight(visualisation: AssistantVisualisation): number;
+    private shouldShowChartLegend;
     protected chartAriaLabel(visualisation: AssistantVisualisation): string;
-    private chartPercentage;
+    private chartColour;
+    private colourWithOpacity;
     protected formatTraceValue(value: AssistantFieldValue | undefined): string;
     protected traceMap(value: AssistantFieldValue | undefined): AssistantFieldMap | undefined;
     protected traceMapField(value: AssistantFieldValue | undefined, key: string): AssistantFieldMap | undefined;
@@ -740,4 +779,4 @@ declare class MaxAgentShiftCardComponent {
 }
 
 export { MAX_ASSISTANT_CONFIG, MaxAgentEntityOptionComponent, MaxAgentShiftCardComponent, MaxAssistantComponent, MaxAssistantFeedbackService, MaxAssistantService, MaxAssistantSupportService };
-export type { AssistantAnalyticsPage, AssistantApiCall, AssistantCard, AssistantChatProgress, AssistantChatRequest, AssistantChatResponse, AssistantChatStreamEvent, AssistantConfirmation, AssistantContextResolution, AssistantConversationMessage, AssistantDeveloperTrace, AssistantDisplayResponse, AssistantExtractedIntent, AssistantFeedbackCategory, AssistantFeedbackRequest, AssistantFeedbackResponse, AssistantFieldMap, AssistantFieldValue, AssistantHelpGuide, AssistantHelpIcon, AssistantHostAction, AssistantMessage, AssistantPendingAction, AssistantProduct, AssistantRequestContext, AssistantResponseTable, AssistantResponseTableAction, AssistantResponseTableColumn, AssistantResponseTablePagination, AssistantRotaCalendar, AssistantSearchResult, AssistantSelectableEntity, AssistantShiftCard, AssistantShiftCardGroup, AssistantSource, AssistantStructuredAction, AssistantSuggestion, AssistantSuggestionEntity, AssistantSuggestionOption, AssistantSupportSeverity, AssistantSupportTag, AssistantSupportTagSeverity, AssistantSupportTicketRequest, AssistantSupportTicketResponse, AssistantToolExecution, AssistantTraceControl, AssistantTraceStep, AssistantTraceStepCategory, AssistantTraceStepMetadata, AssistantTraceStepStatus, AssistantTraceTechnology, AssistantUser, AssistantVisualisation, MaxAgentShiftCardVariant, MaxAssistantConfig };
+export type { AssistantAnalyticsPage, AssistantApiCall, AssistantCard, AssistantChatActivity, AssistantChatData, AssistantChatDelta, AssistantChatProgress, AssistantChatRequest, AssistantChatResponse, AssistantChatStreamEvent, AssistantConfirmation, AssistantContextResolution, AssistantConversationMessage, AssistantDeveloperTrace, AssistantDisplayResponse, AssistantExtractedIntent, AssistantFeedbackCategory, AssistantFeedbackRequest, AssistantFeedbackResponse, AssistantFieldMap, AssistantFieldValue, AssistantHelpGuide, AssistantHelpIcon, AssistantHostAction, AssistantMessage, AssistantPendingAction, AssistantProduct, AssistantRequestContext, AssistantResponseTable, AssistantResponseTableAction, AssistantResponseTableColumn, AssistantResponseTablePagination, AssistantRotaCalendar, AssistantSearchResult, AssistantSelectableEntity, AssistantShiftCard, AssistantShiftCardGroup, AssistantSource, AssistantStructuredAction, AssistantSuggestion, AssistantSuggestionEntity, AssistantSuggestionOption, AssistantSupportSeverity, AssistantSupportTag, AssistantSupportTagSeverity, AssistantSupportTicketRequest, AssistantSupportTicketResponse, AssistantToolExecution, AssistantTraceControl, AssistantTraceStep, AssistantTraceStepCategory, AssistantTraceStepMetadata, AssistantTraceStepStatus, AssistantTraceTechnology, AssistantUser, AssistantVisualisation, AssistantVisualisationDataset, AssistantVisualisationType, MaxAgentShiftCardVariant, MaxAssistantConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "max-agent-ui",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -9,6 +9,7 @@
     "@angular/common": ">=20.0.0 <22.0.0",
     "@angular/core": ">=20.0.0 <22.0.0",
     "@angular/forms": ">=20.0.0 <22.0.0",
+    "chart.js": ">=4.4.0 <5.0.0",
     "primeicons": "^7.0.0",
     "primeng": ">=20.0.0 <22.0.0",
     "rxjs": "^7.8.0"