@accurix/centrinfo-widget 5.1.1 → 5.2.0

package/dist/{types-D0VIOagk.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.
  *
@@ -80,6 +95,8 @@ interface AnalyticsExplanationFreshnessInput {
 }
 /** Structural explanation shape every surface's DTO satisfies. */
 interface AnalyticsExplanationInput {
+  /** Set only when the backend verified every requested fact. */
+  answerComplete?: boolean;
   explanationId?: string;
   conversationalPreface?: string;
   headline?: string;
@@ -110,6 +127,7 @@ interface AnalyticsExplanationInput {
     action: string;
     why: string;
     successMetric?: string;
+    segment?: string;
     evidenceIds?: string[];
   }>;
   forecast?: {
@@ -125,24 +143,63 @@ interface AnalyticsExplanationInput {
   level?: 'basic' | 'detailed' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
   aiExplanation?: AnalyticsAIExplanationInput | null;
+  /** Ranked measured drivers (association, never proof of cause). */
+  drivers?: Array<{
+    text: string;
+    basis?: string;
+    evidenceIds?: string[];
+  }>;
+  /** Cited unusual values. */
+  anomalies?: Array<{
+    text: string;
+    evidenceIds?: string[];
+  }>;
+  /** General business guidance, NOT from the customer's data (label "guidance"). */
+  frameworks?: Array<{
+    name: string;
+    label?: string;
+    guidance: string;
+    fieldMapping?: Array<{
+      concept: string;
+      field?: string;
+      status: string;
+    }>;
+    evidenceIds?: string[];
+  }>;
+  /** Business concepts the answer needed that the data does not hold. */
+  dataGaps?: Array<{
+    concept: string;
+    text: string;
+  }>;
+  /** Governed facts the AI wording did not cover, added beside it. */
+  supplementaryFindings?: string[];
 }
-/** State of the detailed AI explanation, as returned by every surface. */
+/**
+ * State of the detailed AI explanation, as returned by every surface. The
+ * backend may also send "governed" (the checked governed explanation is
+ * final); it is read as `not_requested` — not a failure.
+ */
 type AnalyticsAIExplanationStatus = 'pending' | 'ready' | 'failed' | 'not_requested';
 interface AnalyticsAIExplanationInput {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: when the backend job's budget ends (ISO time). */
+  deadlineAt?: string;
+  /** Pending only: seconds left in the job's budget at response time (clock-skew safe). */
+  waitSeconds?: number;
 }
 declare const ANALYTICS_EXPLANATION_COPY: {
   readonly eyebrow: "Answer from your data";
   readonly provenanceAI: "AI-assisted · evidence checked";
+  readonly provenanceCalculated: "Calculated results";
   readonly provenanceGoverned: "Based on current values";
   readonly comparison: "Comparison";
   readonly conclusions: "What we can conclude";
   readonly whyItMatters: "Why it matters";
   readonly limits: "Important limits";
   readonly investigate: "Investigate further";
-  readonly evidenceList: "Evidence checked";
+  readonly evidenceList: "Supporting evidence";
   readonly causes: "Possible causes";
   readonly causesHint: "Not proven causes";
   readonly howToCheck: "How to check:";
@@ -151,6 +208,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly outlook: "Outlook";
   readonly followUps: "Ask a follow-up";
   readonly sourceNoteAI: "AI-assisted wording, checked against the live values shown here.";
+  readonly sourceNoteCalculated: "AI-assisted wording based on calculated results.";
   readonly sourceNoteGoverned: "Based only on the live values shown here.";
   readonly evidence: "Evidence";
   readonly evidenceMetric: "Metric";
@@ -178,10 +236,20 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly notComparable: "Not comparable yet";
   readonly basicExplanation: "Basic explanation";
   readonly preparingDetailed: "Preparing a detailed explanation…";
+  readonly stillWorkingDetailed: "Still working on the detailed explanation…";
   readonly detailedReady: "Detailed explanation ready.";
   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";
+  readonly supplementaryFindings: "Also in the data";
+  readonly frameworks: "General guidance, not from your data";
+  readonly dataGaps: "Missing data";
+  readonly segment: "Segment:";
+  readonly tasks: "Tasks";
   readonly inProgress: "in progress";
   readonly expand: "Expand explanation";
   readonly collapse: "Collapse explanation";
@@ -261,6 +329,9 @@ interface AnalyticsAIExplanationJob<E extends AnalyticsExplanationInput> {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: the job's deadline (ISO) and seconds left (see AnalyticsAIExplanationInput). */
+  deadlineAt?: string;
+  waitSeconds?: number;
   explanation?: E | null;
   /**
    * The free basic explanation as updated by the background job (it gains the
@@ -274,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
@@ -366,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
@@ -442,6 +517,8 @@ interface WidgetStrings {
   stop: string;
   copy: string;
   copied: string;
+  doubleCheckResponse: string;
+  retryResponse: string;
   retry: string;
   clearChat: string;
   clearChatConfirm: string;
@@ -629,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;
@@ -741,6 +819,7 @@ interface AnalyticsValueProvenance {
   reason?: string;
 }
 interface AnalyticsVisualizationExplanation {
+  answerComplete?: boolean;
   /** Stable opaque id; used only for "Was this helpful?" feedback. */
   explanationId?: string;
   conversationalPreface?: string;
@@ -785,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;
@@ -947,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;
@@ -974,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. */
@@ -1067,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;
@@ -1106,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. */
@@ -1160,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';
@@ -1184,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. */
@@ -1308,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;
@@ -1527,6 +1627,7 @@ interface Visitor {
 }
 /** Persona + capabilities returned by `GET /public-chat/bootstrap`. */
 interface BootstrapInfo {
+  testMode?: boolean;
   agentName: string;
   agentAvatarUrl?: string;
   greeting: string;
@@ -1598,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-k3nQBQjf.d.mts → types-CmLbqY23.d.mts}

@@ -1,6 +1,22 @@
-import * as preact3 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
@@ -83,6 +99,8 @@ interface AnalyticsExplanationFreshnessInput {
 }
 /** Structural explanation shape every surface's DTO satisfies. */
 interface AnalyticsExplanationInput {
+  /** Set only when the backend verified every requested fact. */
+  answerComplete?: boolean;
   explanationId?: string;
   conversationalPreface?: string;
   headline?: string;
@@ -113,6 +131,7 @@ interface AnalyticsExplanationInput {
     action: string;
     why: string;
     successMetric?: string;
+    segment?: string;
     evidenceIds?: string[];
   }>;
   forecast?: {
@@ -128,24 +147,63 @@ interface AnalyticsExplanationInput {
   level?: 'basic' | 'detailed' | string;
   /** The detailed AI explanation that loads separately (poll by explanationId). */
   aiExplanation?: AnalyticsAIExplanationInput | null;
+  /** Ranked measured drivers (association, never proof of cause). */
+  drivers?: Array<{
+    text: string;
+    basis?: string;
+    evidenceIds?: string[];
+  }>;
+  /** Cited unusual values. */
+  anomalies?: Array<{
+    text: string;
+    evidenceIds?: string[];
+  }>;
+  /** General business guidance, NOT from the customer's data (label "guidance"). */
+  frameworks?: Array<{
+    name: string;
+    label?: string;
+    guidance: string;
+    fieldMapping?: Array<{
+      concept: string;
+      field?: string;
+      status: string;
+    }>;
+    evidenceIds?: string[];
+  }>;
+  /** Business concepts the answer needed that the data does not hold. */
+  dataGaps?: Array<{
+    concept: string;
+    text: string;
+  }>;
+  /** Governed facts the AI wording did not cover, added beside it. */
+  supplementaryFindings?: string[];
 }
-/** State of the detailed AI explanation, as returned by every surface. */
+/**
+ * State of the detailed AI explanation, as returned by every surface. The
+ * backend may also send "governed" (the checked governed explanation is
+ * final); it is read as `not_requested` — not a failure.
+ */
 type AnalyticsAIExplanationStatus = 'pending' | 'ready' | 'failed' | 'not_requested';
 interface AnalyticsAIExplanationInput {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: when the backend job's budget ends (ISO time). */
+  deadlineAt?: string;
+  /** Pending only: seconds left in the job's budget at response time (clock-skew safe). */
+  waitSeconds?: number;
 }
 declare const ANALYTICS_EXPLANATION_COPY: {
   readonly eyebrow: "Answer from your data";
   readonly provenanceAI: "AI-assisted · evidence checked";
+  readonly provenanceCalculated: "Calculated results";
   readonly provenanceGoverned: "Based on current values";
   readonly comparison: "Comparison";
   readonly conclusions: "What we can conclude";
   readonly whyItMatters: "Why it matters";
   readonly limits: "Important limits";
   readonly investigate: "Investigate further";
-  readonly evidenceList: "Evidence checked";
+  readonly evidenceList: "Supporting evidence";
   readonly causes: "Possible causes";
   readonly causesHint: "Not proven causes";
   readonly howToCheck: "How to check:";
@@ -154,6 +212,7 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly outlook: "Outlook";
   readonly followUps: "Ask a follow-up";
   readonly sourceNoteAI: "AI-assisted wording, checked against the live values shown here.";
+  readonly sourceNoteCalculated: "AI-assisted wording based on calculated results.";
   readonly sourceNoteGoverned: "Based only on the live values shown here.";
   readonly evidence: "Evidence";
   readonly evidenceMetric: "Metric";
@@ -181,10 +240,20 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly notComparable: "Not comparable yet";
   readonly basicExplanation: "Basic explanation";
   readonly preparingDetailed: "Preparing a detailed explanation…";
+  readonly stillWorkingDetailed: "Still working on the detailed explanation…";
   readonly detailedReady: "Detailed explanation ready.";
   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";
+  readonly supplementaryFindings: "Also in the data";
+  readonly frameworks: "General guidance, not from your data";
+  readonly dataGaps: "Missing data";
+  readonly segment: "Segment:";
+  readonly tasks: "Tasks";
   readonly inProgress: "in progress";
   readonly expand: "Expand explanation";
   readonly collapse: "Collapse explanation";
@@ -264,6 +333,9 @@ interface AnalyticsAIExplanationJob<E extends AnalyticsExplanationInput> {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  /** Pending only: the job's deadline (ISO) and seconds left (see AnalyticsAIExplanationInput). */
+  deadlineAt?: string;
+  waitSeconds?: number;
   explanation?: E | null;
   /**
    * The free basic explanation as updated by the background job (it gains the
@@ -277,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
@@ -479,6 +551,7 @@ interface ResultColumn {
   currencyCode?: string;
   formatPattern?: string;
   grain?: ResultGrain;
+  semanticRole?: AnalyticsVisualizationColumn$1['semanticRole'];
 }
 interface ResultTableClassNames {
   wrap?: string;
@@ -529,7 +602,7 @@ declare const WidgetAnalyticsChart: ({
   expanded?: boolean;
   /** Class prefix of the surface (`cf` widget, `ca` chat app). */
   classPrefix?: string;
-}) => preact3.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;
@@ -556,7 +629,7 @@ declare const ResultTable: ({
   expanded,
   classNames,
   emptyLabel
-}: ResultTableProps) => preact3.JSX.Element;
+}: ResultTableProps) => preact2.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result-details.d.ts
 interface AnalyticsResultDetail {
@@ -574,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
@@ -650,6 +727,8 @@ interface WidgetStrings {
   stop: string;
   copy: string;
   copied: string;
+  doubleCheckResponse: string;
+  retryResponse: string;
   retry: string;
   clearChat: string;
   clearChatConfirm: string;
@@ -779,7 +858,7 @@ interface WidgetStrings {
   previewActionNote: string;
   previewBanner: string;
 }
-declare const StringsProvider: preact3.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. */
@@ -837,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;
@@ -949,6 +1029,7 @@ interface AnalyticsValueProvenance {
   reason?: string;
 }
 interface AnalyticsVisualizationExplanation {
+  answerComplete?: boolean;
   /** Stable opaque id; used only for "Was this helpful?" feedback. */
   explanationId?: string;
   conversationalPreface?: string;
@@ -993,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;
@@ -1155,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;
@@ -1182,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. */
@@ -1275,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;
@@ -1314,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. */
@@ -1368,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';
@@ -1392,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. */
@@ -1516,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;
@@ -1735,6 +1837,7 @@ interface Visitor {
 }
 /** Persona + capabilities returned by `GET /public-chat/bootstrap`. */
 interface BootstrapInfo {
+  testMode?: boolean;
   agentName: string;
   agentAvatarUrl?: string;
   greeting: string;
@@ -1806,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.1",
+  "version": "5.2.0",
   "private": false,
   "type": "module",
   "sideEffects": [
@@ -44,7 +44,7 @@
     "preact": "^10.27.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.50.0",
+    "@playwright/test": "^1.61.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.0",
     "eslint": "^9.27.0",