@accurix/centrinfo-widget 5.1.2 → 5.2.0

package/dist/{types-BuoTcoZu.d.cts → types-CCk7I1fM.d.cts}

@@ -1,7 +1,22 @@
 import * as preact0 from "preact";
 
+//#region ../centrinfo-results/src/answer.d.ts
+interface CentrinfoAnswer<Visualization = unknown, Source$1 = unknown, Artifact = unknown, Presentation = unknown> {
+  version: number;
+  kind: string;
+  status: string;
+  text: string;
+  explanation?: Record<string, unknown>;
+  visualization?: Visualization;
+  sources?: Source$1[];
+  artifacts?: Artifact[];
+  presentation?: Presentation;
+  feedbackId?: string;
+  generatedAt?: string;
+  timezone?: string;
+}
+//#endregion
 //#region ../centrinfo-results/src/analytics-explanation.d.ts
-
 /**
  * Framework-agnostic analytics explanation core.
  *
@@ -226,6 +241,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly detailedUnavailable: "A detailed explanation is not available right now.";
   readonly detailedRetry: "Try again";
   readonly region: "Explanation";
+  readonly details: "What this means";
   readonly drivers: "What is driving it";
   readonly driversHint: "Measured association, not proof of cause";
   readonly anomalies: "Unusual values";
@@ -329,8 +345,8 @@ interface AnalyticsAIExplanationTransport<E extends AnalyticsExplanationInput> {
   poll: (explanationId: string, signal?: AbortSignal) => Promise<AnalyticsAIExplanationJob<E>>;
   /** "Try again": re-request with the retry flag. Omit when retry is impossible. */
   retry?: (explanationId: string, signal?: AbortSignal) => Promise<AnalyticsAIExplanationJob<E>>;
-  /** The job reached a final status: let the surface remember it (status only, not the payload). */
-  settled?: (explanationId: string, status: 'ready' | 'failed' | 'not_requested') => void;
+  /** Remember the checked explanation alongside its final status. */
+  settled?: (explanationId: string, status: 'ready' | 'failed' | 'not_requested', explanation?: E) => void;
 }
 //#endregion
 //#region ../centrinfo-results/src/labels.d.ts
@@ -421,6 +437,10 @@ interface ResultLabels {
  * never produces.
  */
 interface WidgetStrings {
+  analyticsModelLabel: string;
+  analyticsModelAutomatic: string;
+  analyticsModelUnavailable: string;
+  testMode?: string;
   /**
    * Labels for analytics answers (KPI, chart, table, details, explanation).
    * Any subset overrides the English defaults; `explanation` holds the
@@ -497,6 +517,8 @@ interface WidgetStrings {
   stop: string;
   copy: string;
   copied: string;
+  doubleCheckResponse: string;
+  retryResponse: string;
   retry: string;
   clearChat: string;
   clearChatConfirm: string;
@@ -684,6 +706,7 @@ interface LiveAudioSegment {
   text?: string;
 }
 interface TurnResult {
+  answerResult?: CentrinfoAnswer<AnalyticsVisualization, Source, ChatArtifact>;
   /** True when the reply was spoken in live pieces (onAudioSegment). */
   liveAudio?: boolean;
   answer: string;
@@ -841,11 +864,7 @@ interface AnalyticsVisualizationExplanation {
   followUps?: string[];
   source: 'governed_result' | 'ai_grounded' | 'rag_deterministic_analysis' | 'analysis_contract' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
-  aiExplanation?: {
-    status: string;
-    explanationId?: string;
-    retryAvailable?: boolean;
-  } | null;
+  aiExplanation?: AnalyticsAIExplanationInput | null;
 }
 interface AnalyticsVisualizationAnalysis {
   summary: string;
@@ -1003,6 +1022,10 @@ interface LiveEventsResult {
   events: LiveEvent[];
 }
 interface AuthenticatedHistoryMessage {
+  answerResult?: CentrinfoAnswer<AnalyticsVisualization, {
+    title?: string;
+    url?: string;
+  }, ChatArtifact>;
   id: string;
   role: 'user' | 'assistant' | 'system';
   content: string;
@@ -1030,6 +1053,7 @@ interface AuthenticatedHistoryResult {
   conversations: AuthenticatedHistoryConversation[];
 }
 interface StreamCallbacks {
+  analyticsModelId?: string;
   /** Called with each incremental text chunk. */
   onChunk: (text: string) => void;
   /** The answer text and metadata have arrived; optional reply audio may follow. */
@@ -1123,10 +1147,7 @@ interface ExplanationFeedbackInput {
 /** Detailed AI explanation job for an analytics answer
  * (GET /public-chat/analytics-explanations/:id). `explanation` is set only
  * when ready and is the checked, public-safe explanation. */
-interface ExplanationJob {
-  status: 'pending' | 'ready' | 'failed' | 'not_requested' | string;
-  explanationId?: string;
-  retryAvailable?: boolean;
+interface ExplanationJob extends AnalyticsAIExplanationInput {
   explanation?: Record<string, unknown> | null;
   /** The free basic explanation as updated by the job (gains the baseline sentence). */
   basic?: Record<string, unknown> | null;
@@ -1162,9 +1183,11 @@ interface GifResult {
  * backend (`ApiClient`) or the in-memory demo (`MockTransport`).
  */
 interface Transport {
+  analyticsModels?(): Promise<AnalyticsModelOption[]>;
   bootstrap(): Promise<BootstrapInfo>;
   /** Server-backed history for the verified SDK customer. Anonymous returns empty. */
   history(): Promise<AuthenticatedHistoryResult>;
+  updateHistory?(sessionId: string, action: 'rename' | 'delete', title?: string): Promise<void>;
   /** Stream a turn; resolves with final metadata once `done`. */
   stream(question: string, sessionId: string, cb: StreamCallbacks): Promise<TurnResult>;
   /** Poll for staff/system events after a timestamp during live handoff. */
@@ -1216,6 +1239,10 @@ interface Transport {
   /** "Try again" on a failed detailed AI explanation. Optional. */
   retryExplanation?(explanationId: string, sessionId: string, surface?: 'widget' | 'chat_app'): Promise<ExplanationJob>;
 }
+interface AnalyticsModelOption {
+  id: string;
+  name: string;
+}
 //#endregion
 //#region src/types.d.ts
 type ChatSurface = 'floating' | 'full-page';
@@ -1240,6 +1267,23 @@ interface WidgetTranslationBundle {
 }
 /** Public configuration surface passed to `Centrinfo.init()` / <CentrinfoWidget>. */
 interface WidgetConfig {
+  /** Simple brand settings shared by the floating widget and full-page chat. */
+  branding?: {
+    name?: string;
+    logo?: string;
+    color?: string;
+  };
+  /** Simple composer options. Hiding a control does not change backend permissions. */
+  composer?: {
+    placeholder?: string;
+    attachments?: boolean;
+    voice?: boolean;
+    modelSelector?: boolean;
+  };
+  /** Show the permitted analytics data models in chat. Defaults to true. */
+  showAnalyticsModelSelector?: boolean;
+  /** Initial analytics data model; backend permissions are always enforced. */
+  analyticsModelId?: string;
   /** The org's public chat token (`pub_*`). Required. It IS the org identity. */
   token: string;
   /** Conversation namespace. Set by the SDK surface mounting the chat. */
@@ -1364,7 +1408,7 @@ interface WidgetConfig {
   /**
    * How often the open widget refreshes its public token configuration
    * (branding, greeting, starter questions, allowed actions, pause/offline
-   * state) from `/public-chat/bootstrap`. Default 30 seconds; set 0 to
+   * state) from `/public-chat/bootstrap`. Default 300 seconds; set 0 to
    * disable live config refresh for strict traffic budgets.
    */
   configRefreshSeconds?: number;
@@ -1583,6 +1627,7 @@ interface Visitor {
 }
 /** Persona + capabilities returned by `GET /public-chat/bootstrap`. */
 interface BootstrapInfo {
+  testMode?: boolean;
   agentName: string;
   agentAvatarUrl?: string;
   greeting: string;
@@ -1654,4 +1699,4 @@ interface SchedulerInfo {
   };
 }
 //#endregion
-export { StringsProvider as C, AnalyticsExplanationInput as D, AnalyticsAIExplanationTransport as E, AnalyticsGroupComparisonPoint as O, Transport as S, ResultLabels as T, DemoSlotsResult as _, MessageAttachment as a, PublicChatAction as b, Visitor as c, WidgetHandle as d, WidgetThemeTokens as f, DemoBooking as g, AnalyticsVisualization as h, FeaturedLink as i, AnalyticsPeriodComparison as k, WidgetActionTranslation as l, ActionResult as m, ChatArtifact as n, SchedulerInfo as o, WidgetUser as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, ExplanationFeedbackInput as v, WidgetStrings as w, PublicChatActionField as x, GifResult as y };
+export { AnalyticsPeriodComparison as A, Transport as C, AnalyticsAIExplanationTransport as D, ResultLabels as E, AnalyticsExplanationInput as O, PublicChatActionField as S, WidgetStrings as T, DemoBooking as _, MessageAttachment as a, GifResult as b, Visitor as c, WidgetHandle as d, WidgetThemeTokens as f, AnalyticsVisualization as g, AnalyticsModelOption as h, FeaturedLink as i, AnalyticsGroupComparisonPoint as k, WidgetActionTranslation as l, ActionResult as m, ChatArtifact as n, SchedulerInfo as o, WidgetUser as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, DemoSlotsResult as v, StringsProvider as w, PublicChatAction as x, ExplanationFeedbackInput as y };

package/dist/{types-3zpBBhPI.d.mts → types-CmLbqY23.d.mts}

@@ -1,6 +1,22 @@
-import * as preact1 from "preact";
+import * as preact2 from "preact";
 import { JSX } from "preact";
 
+//#region ../centrinfo-results/src/answer.d.ts
+interface CentrinfoAnswer<Visualization = unknown, Source$1 = unknown, Artifact = unknown, Presentation = unknown> {
+  version: number;
+  kind: string;
+  status: string;
+  text: string;
+  explanation?: Record<string, unknown>;
+  visualization?: Visualization;
+  sources?: Source$1[];
+  artifacts?: Artifact[];
+  presentation?: Presentation;
+  feedbackId?: string;
+  generatedAt?: string;
+  timezone?: string;
+}
+//#endregion
 //#region ../centrinfo-results/src/analytics-chart-catalog.d.ts
 type AnalyticsChartCatalogType = 'kpi' | 'table' | 'line' | 'bar' | 'pie' | 'scatter' | 'effectScatter' | 'map' | 'candlestick' | 'boxplot' | 'graph' | 'lines' | 'tree' | 'treemap' | 'sunburst' | 'parallel' | 'sankey' | 'funnel' | 'heatmap' | 'radar' | 'gauge' | 'pictorialBar' | 'themeRiver' | 'matrix' | 'chord' | 'custom' | 'dataset' | 'dataZoom' | 'graphic' | 'richText' | 'globe' | 'bar3D' | 'scatter3D' | 'surface' | 'map3D' | 'lines3D' | 'line3D' | 'scatterGL' | 'linesGL' | 'flowGL' | 'graphGL' | 'polygons3D';
 //#endregion
@@ -229,6 +245,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly detailedUnavailable: "A detailed explanation is not available right now.";
   readonly detailedRetry: "Try again";
   readonly region: "Explanation";
+  readonly details: "What this means";
   readonly drivers: "What is driving it";
   readonly driversHint: "Measured association, not proof of cause";
   readonly anomalies: "Unusual values";
@@ -332,8 +349,8 @@ interface AnalyticsAIExplanationTransport<E extends AnalyticsExplanationInput> {
   poll: (explanationId: string, signal?: AbortSignal) => Promise<AnalyticsAIExplanationJob<E>>;
   /** "Try again": re-request with the retry flag. Omit when retry is impossible. */
   retry?: (explanationId: string, signal?: AbortSignal) => Promise<AnalyticsAIExplanationJob<E>>;
-  /** The job reached a final status: let the surface remember it (status only, not the payload). */
-  settled?: (explanationId: string, status: 'ready' | 'failed' | 'not_requested') => void;
+  /** Remember the checked explanation alongside its final status. */
+  settled?: (explanationId: string, status: 'ready' | 'failed' | 'not_requested', explanation?: E) => void;
 }
 //#endregion
 //#region ../centrinfo-results/src/labels.d.ts
@@ -585,7 +602,7 @@ declare const WidgetAnalyticsChart: ({
   expanded?: boolean;
   /** Class prefix of the surface (`cf` widget, `ca` chat app). */
   classPrefix?: string;
-}) => preact1.JSX.Element;
+}) => preact2.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result.d.ts
 declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn, context?: ResultFormatContext) => string;
@@ -612,7 +629,7 @@ declare const ResultTable: ({
   expanded,
   classNames,
   emptyLabel
-}: ResultTableProps) => preact1.JSX.Element;
+}: ResultTableProps) => preact2.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result-details.d.ts
 interface AnalyticsResultDetail {
@@ -630,6 +647,10 @@ interface AnalyticsResultDetail {
  * never produces.
  */
 interface WidgetStrings {
+  analyticsModelLabel: string;
+  analyticsModelAutomatic: string;
+  analyticsModelUnavailable: string;
+  testMode?: string;
   /**
    * Labels for analytics answers (KPI, chart, table, details, explanation).
    * Any subset overrides the English defaults; `explanation` holds the
@@ -706,6 +727,8 @@ interface WidgetStrings {
   stop: string;
   copy: string;
   copied: string;
+  doubleCheckResponse: string;
+  retryResponse: string;
   retry: string;
   clearChat: string;
   clearChatConfirm: string;
@@ -835,7 +858,7 @@ interface WidgetStrings {
   previewActionNote: string;
   previewBanner: string;
 }
-declare const StringsProvider: preact1.Provider<WidgetStrings>;
+declare const StringsProvider: preact2.Provider<WidgetStrings>;
 //#endregion
 //#region src/api/types.d.ts
 /** The result metadata that arrives with (or after) an answer. */
@@ -893,6 +916,7 @@ interface LiveAudioSegment {
   text?: string;
 }
 interface TurnResult {
+  answerResult?: CentrinfoAnswer<AnalyticsVisualization, Source, ChatArtifact>;
   /** True when the reply was spoken in live pieces (onAudioSegment). */
   liveAudio?: boolean;
   answer: string;
@@ -1050,11 +1074,7 @@ interface AnalyticsVisualizationExplanation {
   followUps?: string[];
   source: 'governed_result' | 'ai_grounded' | 'rag_deterministic_analysis' | 'analysis_contract' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
-  aiExplanation?: {
-    status: string;
-    explanationId?: string;
-    retryAvailable?: boolean;
-  } | null;
+  aiExplanation?: AnalyticsAIExplanationInput | null;
 }
 interface AnalyticsVisualizationAnalysis {
   summary: string;
@@ -1212,6 +1232,10 @@ interface LiveEventsResult {
   events: LiveEvent[];
 }
 interface AuthenticatedHistoryMessage {
+  answerResult?: CentrinfoAnswer<AnalyticsVisualization, {
+    title?: string;
+    url?: string;
+  }, ChatArtifact>;
   id: string;
   role: 'user' | 'assistant' | 'system';
   content: string;
@@ -1239,6 +1263,7 @@ interface AuthenticatedHistoryResult {
   conversations: AuthenticatedHistoryConversation[];
 }
 interface StreamCallbacks {
+  analyticsModelId?: string;
   /** Called with each incremental text chunk. */
   onChunk: (text: string) => void;
   /** The answer text and metadata have arrived; optional reply audio may follow. */
@@ -1332,10 +1357,7 @@ interface ExplanationFeedbackInput {
 /** Detailed AI explanation job for an analytics answer
  * (GET /public-chat/analytics-explanations/:id). `explanation` is set only
  * when ready and is the checked, public-safe explanation. */
-interface ExplanationJob {
-  status: 'pending' | 'ready' | 'failed' | 'not_requested' | string;
-  explanationId?: string;
-  retryAvailable?: boolean;
+interface ExplanationJob extends AnalyticsAIExplanationInput {
   explanation?: Record<string, unknown> | null;
   /** The free basic explanation as updated by the job (gains the baseline sentence). */
   basic?: Record<string, unknown> | null;
@@ -1371,9 +1393,11 @@ interface GifResult {
  * backend (`ApiClient`) or the in-memory demo (`MockTransport`).
  */
 interface Transport {
+  analyticsModels?(): Promise<AnalyticsModelOption[]>;
   bootstrap(): Promise<BootstrapInfo>;
   /** Server-backed history for the verified SDK customer. Anonymous returns empty. */
   history(): Promise<AuthenticatedHistoryResult>;
+  updateHistory?(sessionId: string, action: 'rename' | 'delete', title?: string): Promise<void>;
   /** Stream a turn; resolves with final metadata once `done`. */
   stream(question: string, sessionId: string, cb: StreamCallbacks): Promise<TurnResult>;
   /** Poll for staff/system events after a timestamp during live handoff. */
@@ -1425,6 +1449,10 @@ interface Transport {
   /** "Try again" on a failed detailed AI explanation. Optional. */
   retryExplanation?(explanationId: string, sessionId: string, surface?: 'widget' | 'chat_app'): Promise<ExplanationJob>;
 }
+interface AnalyticsModelOption {
+  id: string;
+  name: string;
+}
 //#endregion
 //#region src/types.d.ts
 type ChatSurface = 'floating' | 'full-page';
@@ -1449,6 +1477,23 @@ interface WidgetTranslationBundle {
 }
 /** Public configuration surface passed to `Centrinfo.init()` / <CentrinfoWidget>. */
 interface WidgetConfig {
+  /** Simple brand settings shared by the floating widget and full-page chat. */
+  branding?: {
+    name?: string;
+    logo?: string;
+    color?: string;
+  };
+  /** Simple composer options. Hiding a control does not change backend permissions. */
+  composer?: {
+    placeholder?: string;
+    attachments?: boolean;
+    voice?: boolean;
+    modelSelector?: boolean;
+  };
+  /** Show the permitted analytics data models in chat. Defaults to true. */
+  showAnalyticsModelSelector?: boolean;
+  /** Initial analytics data model; backend permissions are always enforced. */
+  analyticsModelId?: string;
   /** The org's public chat token (`pub_*`). Required. It IS the org identity. */
   token: string;
   /** Conversation namespace. Set by the SDK surface mounting the chat. */
@@ -1573,7 +1618,7 @@ interface WidgetConfig {
   /**
    * How often the open widget refreshes its public token configuration
    * (branding, greeting, starter questions, allowed actions, pause/offline
-   * state) from `/public-chat/bootstrap`. Default 30 seconds; set 0 to
+   * state) from `/public-chat/bootstrap`. Default 300 seconds; set 0 to
    * disable live config refresh for strict traffic budgets.
    */
   configRefreshSeconds?: number;
@@ -1792,6 +1837,7 @@ interface Visitor {
 }
 /** Persona + capabilities returned by `GET /public-chat/bootstrap`. */
 interface BootstrapInfo {
+  testMode?: boolean;
   agentName: string;
   agentAvatarUrl?: string;
   greeting: string;
@@ -1863,4 +1909,4 @@ interface SchedulerInfo {
   };
 }
 //#endregion
-export { buildWidgetAnalyticsChartModel as A, StringsProvider as C, formatResultCell as D, ResultTable as E, AnalyticsAIExplanationTransport as M, AnalyticsExplanationInput as N, serializeResultCsv as O, Transport as S, AnalyticsResultDetail as T, DemoSlotsResult as _, MessageAttachment as a, PublicChatAction as b, Visitor as c, WidgetHandle as d, WidgetThemeTokens as f, DemoBooking as g, AnalyticsVisualization as h, FeaturedLink as i, ResultLabels as j, WidgetAnalyticsChart as k, WidgetActionTranslation as l, ActionResult as m, ChatArtifact as n, SchedulerInfo as o, WidgetUser as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, ExplanationFeedbackInput as v, WidgetStrings as w, PublicChatActionField as x, GifResult as y };
+export { WidgetAnalyticsChart as A, Transport as C, ResultTable as D, AnalyticsResultDetail as E, ResultLabels as M, AnalyticsAIExplanationTransport as N, formatResultCell as O, AnalyticsExplanationInput as P, PublicChatActionField as S, WidgetStrings as T, DemoBooking as _, MessageAttachment as a, GifResult as b, Visitor as c, WidgetHandle as d, WidgetThemeTokens as f, AnalyticsVisualization as g, AnalyticsModelOption as h, FeaturedLink as i, buildWidgetAnalyticsChartModel as j, serializeResultCsv as k, WidgetActionTranslation as l, ActionResult as m, ChatArtifact as n, SchedulerInfo as o, WidgetUser as p, ChatMessage as r, Source as s, BootstrapInfo as t, WidgetConfig as u, DemoSlotsResult as v, StringsProvider as w, PublicChatAction as x, ExplanationFeedbackInput as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accurix/centrinfo-widget",
-  "version": "5.1.2",
+  "version": "5.2.0",
   "private": false,
   "type": "module",
   "sideEffects": [