@accurix/centrinfo-widget 5.1.2 → 5.2.1

package/dist/{types-BuoTcoZu.d.cts → types-95uGbSpk.d.mts}

@@ -1,7 +1,26 @@
-import * as preact0 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
 //#region ../centrinfo-results/src/analytics-explanation.d.ts
-
 /**
  * Framework-agnostic analytics explanation core.
  *
@@ -169,6 +188,7 @@ interface AnalyticsAIExplanationInput {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  retryAfterSeconds?: number;
   /** 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). */
@@ -222,10 +242,12 @@ declare const ANALYTICS_EXPLANATION_COPY: {
   readonly basicExplanation: "Basic explanation";
   readonly preparingDetailed: "Preparing a detailed explanation…";
   readonly stillWorkingDetailed: "Still working on the detailed explanation…";
+  readonly waitingToRetry: "Waiting briefly before retrying 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";
@@ -313,6 +335,7 @@ interface AnalyticsAIExplanationJob<E extends AnalyticsExplanationInput> {
   status: AnalyticsAIExplanationStatus | string;
   explanationId?: string;
   retryAvailable?: boolean;
+  retryAfterSeconds?: number;
   /** Pending only: the job's deadline (ISO) and seconds left (see AnalyticsAIExplanationInput). */
   deadlineAt?: string;
   waitSeconds?: number;
@@ -329,14 +352,194 @@ 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/format.d.ts
+/**
+ * The one place numbers, currency, percentages and dates are formatted, so the
+ * chart axis, tooltip, table and KPI show the same value the same way.
+ *
+ * Rules:
+ * - Currency comes from column metadata (`currencyCode`) or the result's fixed
+ *   currency. With no known code the amount is shown as a plain number.
+ * - A `percent` column is read as percentage points (0.5 is "0.5%") unless its
+ *   `formatPattern` contains `%` (Excel style), which marks a fraction (0.5 is
+ *   "50%"). Magnitude is never used to guess.
+ * - Date-only values (`2024-03-05`) are calendar dates: they are formatted in
+ *   UTC so they never shift a day. Instants are formatted in the result
+ *   timezone. Granularity follows column metadata, the result's comparison
+ *   grain, or the shape of the values — a daily series is never "Mar 2024".
+ */
+type ResultGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+interface ResultFormatContext {
+  locale?: string;
+  /** IANA zone of the result; used for instants, never for date-only values. */
+  timezone?: string;
+  grain?: ResultGrain;
+  /** Result-level fixed currency, used when the column has none. */
+  currencyCode?: string;
+  yes?: string;
+  no?: string;
+}
+//#endregion
+//#region ../centrinfo-results/src/types.d.ts
+interface AnalyticsVisualizationColumn$1 {
+  key: string;
+  label: string;
+  dataType: 'text' | 'number' | 'currency' | 'percent' | 'boolean' | 'date' | 'datetime';
+  semanticRole: 'identifier' | 'dimension' | 'measure' | 'date' | 'geography' | 'boolean';
+  aggregation?: 'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max';
+  allowedAggregations?: Array<'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max'>;
+  formatPattern?: string;
+  currencyCode?: string;
+  /** Time granularity of a date column; drives how its values are labelled. */
+  grain?: ResultGrain;
+  timeGrain?: string;
+  description?: string;
+  priority?: 'primary' | 'secondary' | 'detail';
+  sortable?: boolean;
+  filterable?: boolean;
+  groupable?: boolean;
+}
+interface AnalyticsVisualizationRecommendation$1 {
+  layers?: AnalyticsChartLayer[];
+  type: AnalyticsChartCatalogType | 'area' | 'stacked_bar';
+  mode: string;
+  categoryField?: string;
+  latitudeField?: string;
+  longitudeField?: string;
+  geometryField?: string;
+  valueFields?: string[];
+  seriesField?: string;
+  reason?: string;
+  confidence?: number;
+}
+interface AnalyticsVisualization$1 {
+  truncated?: boolean;
+  maxSeries?: number;
+  valueProvenance?: Array<{
+    rowIndex: number;
+    field: string;
+    status?: string;
+    filled?: string;
+  }>;
+  panels?: Array<{
+    id: string;
+    title: string;
+    status: string;
+    visualization?: AnalyticsVisualization$1;
+  }>;
+  /** The latest time bucket is still in progress (drawn dashed). */
+  lastPeriodInProgress?: boolean;
+  /** Like-for-like comparison basis (reader-safe). */
+  periodComparison?: AnalyticsPeriodComparison;
+  version?: number;
+  presentation?: 'kpi' | 'chart' | 'table';
+  type: AnalyticsChartCatalogType | 'area' | 'stacked_bar';
+  title?: string;
+  label?: string;
+  value?: string;
+  latitudeField?: string;
+  longitudeField?: string;
+  geometryField?: string;
+  valueFields?: string[];
+  series?: string;
+  seriesField?: string;
+  columns?: string[];
+  rows?: Array<Record<string, unknown>>;
+  rowCount?: number;
+  timezone?: string;
+  freshness?: {
+    status?: string;
+    answeredAt?: string;
+  };
+  reportingPeriod?: {
+    label?: string;
+    start?: string;
+    end?: string;
+    timezone?: string;
+  };
+  appliedFilters?: Array<{
+    field: string;
+    operator: string;
+    value: unknown;
+  }>;
+  explanation?: {
+    checkedAt?: string;
+    timezone?: string;
+    dataFreshness?: {
+      status?: string;
+    };
+  };
+  expandable?: boolean;
+  tableAvailable?: boolean;
+  downloadAvailable?: boolean;
+  columnMetadata?: AnalyticsVisualizationColumn$1[];
+  currency?: {
+    code?: string;
+    field?: string;
+    source?: 'fixed_metadata' | 'source_field';
+    isMixed: boolean;
+  };
+  chartRecommendation?: AnalyticsVisualizationRecommendation$1;
+}
+interface ResultColumn {
+  key: string;
+  label?: string;
+  dataType?: AnalyticsVisualizationColumn$1['dataType'];
+  currencyCode?: string;
+  formatPattern?: string;
+  grain?: ResultGrain;
+  semanticRole?: AnalyticsVisualizationColumn$1['semanticRole'];
+}
+interface ResultTableClassNames {
+  wrap?: string;
+  table?: string;
+  note?: string;
+}
+//#endregion
+//#region ../centrinfo-results/src/combo-chart.d.ts
+/** References governed result columns. Layers never contain queries or data. */
+interface AnalyticsChartLayer {
+  sourceTitle?: string;
+  categorySourceTitle?: string;
+  type: 'line' | 'bar';
+  mode: string;
+  categoryField: string;
+  valueField: string;
+  seriesField?: string;
+  axis: 'y1' | 'y2';
+}
+interface AnalyticsComboModel {
+  categories: string[];
+  categoryLabel: string;
+  series: Array<{
+    layer: number;
+    name: string;
+    type: 'line' | 'bar';
+    area: boolean;
+    stack?: string;
+    axis: number;
+    column: AnalyticsVisualizationColumn$1;
+    values: Array<number | null>;
+    reference?: boolean;
+  }>;
+  axes: Array<{
+    label: string;
+    column: AnalyticsVisualizationColumn$1;
+  }>;
+  omittedSeriesCount: number;
+  partial: boolean;
+  locale?: string;
 }
 //#endregion
 //#region ../centrinfo-results/src/labels.d.ts
 type AnalyticsExplanationCopy = Required<AnalyticsExplanationCopyOverrides>;
 /** Every string the shared result renderer shows. Hosts override any subset. */
 interface ResultLabels {
+  analysisUnavailable: string;
   resultDetails: string;
   liveMetric: string;
   currentValue: string;
@@ -349,6 +552,10 @@ interface ResultLabels {
   aggregateCharge: string;
   chartFallback: string;
   chartLine: string;
+  chartArea: string;
+  chartCombo: string;
+  chartAreaHint: string;
+  chartComboHint: string;
   chartBar: string;
   chartStackedBar: string;
   chartLineHint: string;
@@ -386,6 +593,7 @@ interface ResultLabels {
   /** `{measure}`, `{dimension}`. */
   chartTitle: string;
   seriesLimited: string;
+  partialChart: string;
   summaryLatest: string;
   summaryNoTrend: string;
   summaryHighest: string;
@@ -411,6 +619,86 @@ interface ResultLabels {
   governedResult: string;
 }
 //#endregion
+//#region ../centrinfo-results/src/chart.d.ts
+type WidgetAnalyticsSeries = {
+  field: string;
+  name: string;
+  values: Array<number | null>;
+  valueColumn?: AnalyticsVisualizationColumn$1;
+  /** Like-for-like breakdown: per-point comparison (tooltip detail). */
+  points?: Array<AnalyticsGroupComparisonPoint | undefined>;
+};
+type WidgetAnalyticsChartType = 'line' | 'area' | 'bar' | 'stacked_bar' | 'combo';
+type WidgetAnalyticsChartModel = {
+  combo?: AnalyticsComboModel;
+  type: WidgetAnalyticsChartType;
+  title: string;
+  xAxisTitle: string;
+  yAxisTitle: string;
+  categories: string[];
+  series: WidgetAnalyticsSeries[];
+  summary: string;
+  omittedSeriesCount: number;
+  /** Index of the in-progress (latest) time bucket, drawn dashed / faded. */
+  inProgressIndex?: number;
+  /** Like-for-like breakdown: the comparison drawn (previous-to-date bars). */
+  comparison?: AnalyticsPeriodComparison;
+  /** "Today so far, compared with yesterday at this time". */
+  comparisonNote?: string;
+  locale?: string;
+  /** Resolved copy used by the chart's tooltips, summary and zoom controls. */
+  labels: ResultLabels;
+};
+type WidgetAnalyticsChartOptions = {
+  maxSeries?: number;
+  locale?: string;
+  labels?: Partial<ResultLabels>;
+};
+declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType, options?: WidgetAnalyticsChartOptions) => WidgetAnalyticsChartModel | null;
+declare const WidgetAnalyticsChart: ({
+  model,
+  expanded,
+  classPrefix: p
+}: {
+  model: WidgetAnalyticsChartModel;
+  expanded?: boolean;
+  /** Class prefix of the surface (`cf` widget, `ca` chat app). */
+  classPrefix?: string;
+}) => preact2.JSX.Element;
+//#endregion
+//#region ../centrinfo-results/src/result.d.ts
+declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn, context?: ResultFormatContext) => string;
+declare const serializeResultCsv: (rows: Array<Record<string, unknown>>, columns?: Array<string | ResultColumn>) => string;
+//#endregion
+//#region ../centrinfo-results/src/table.d.ts
+interface ResultTableProps {
+  rows: Array<Record<string, unknown>>;
+  columns?: Array<string | ResultColumn>;
+  maxRows?: number;
+  locale?: string;
+  /** Timezone / grain / currency context so cells format like the chart. */
+  format?: ResultFormatContext;
+  expanded?: boolean;
+  classNames?: ResultTableClassNames;
+  emptyLabel?: string;
+}
+declare const ResultTable: ({
+  rows,
+  columns,
+  maxRows,
+  locale,
+  format,
+  expanded,
+  classNames,
+  emptyLabel
+}: ResultTableProps) => preact2.JSX.Element;
+//#endregion
+//#region ../centrinfo-results/src/result-details.d.ts
+interface AnalyticsResultDetail {
+  label: string;
+  value: string;
+}
+//#endregion
 //#region src/i18n.d.ts
 /**
  * Every user-visible chrome string in one place. The widget ships English
@@ -421,6 +709,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 +789,8 @@ interface WidgetStrings {
   stop: string;
   copy: string;
   copied: string;
+  doubleCheckResponse: string;
+  retryResponse: string;
   retry: string;
   clearChat: string;
   clearChatConfirm: string;
@@ -626,7 +920,7 @@ interface WidgetStrings {
   previewActionNote: string;
   previewBanner: string;
 }
-declare const StringsProvider: preact0.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. */
@@ -684,6 +978,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;
@@ -715,6 +1010,7 @@ interface AnalyticsVisualizationColumn {
   label: string;
   dataType: 'text' | 'number' | 'currency' | 'percent' | 'boolean' | 'date' | 'datetime';
   semanticRole: 'identifier' | 'dimension' | 'measure' | 'date' | 'geography' | 'boolean';
+  timeGrain?: string;
   aggregation?: 'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max';
   allowedAggregations?: Array<'none' | 'sum' | 'avg' | 'count' | 'count_distinct' | 'min' | 'max'>;
   formatPattern?: string;
@@ -726,6 +1022,7 @@ interface AnalyticsVisualizationColumn {
   groupable?: boolean;
 }
 interface AnalyticsVisualizationRecommendation {
+  layers?: AnalyticsChartLayer[];
   type: 'kpi' | 'table' | 'line' | 'area' | 'bar' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel' | 'heatmap' | 'radar';
   mode: string;
   categoryField?: string;
@@ -841,11 +1138,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;
@@ -921,6 +1214,12 @@ interface AnalyticsVisualizationBusinessAnalysis {
   coverage?: AnalyticsVisualizationAnalysisCoverage;
 }
 interface AnalyticsVisualization {
+  panels?: Array<{
+    id: string;
+    title: string;
+    status: string;
+    visualization?: AnalyticsVisualization;
+  }>;
   version?: number;
   presentation?: 'kpi' | 'chart' | 'table';
   type: 'kpi' | 'table' | 'bar' | 'line' | 'area' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel' | 'heatmap' | 'radar';
@@ -1003,6 +1302,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 +1333,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 +1427,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 +1463,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 +1519,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 +1547,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 +1688,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 +1907,7 @@ interface Visitor {
 }
 /** Persona + capabilities returned by `GET /public-chat/bootstrap`. */
 interface BootstrapInfo {
+  testMode?: boolean;
   agentName: string;
   agentAvatarUrl?: string;
   greeting: string;
@@ -1654,4 +1979,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 { 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 };