@accurix/centrinfo-widget 4.0.0 → 5.1.0

package/dist/runtime.cjs

@@ -1 +1,2 @@
-const e=require(`./config-DsNMbdKp.cjs`),t=t=>t.demo?new e.S:t.preview?new e.x(new e.C(t.apiBaseUrl,t.token,t.gifApiKey,t.analyticsContextToken,{agentName:t.agentName,agentAvatarUrl:t.agentAvatarUrl},t.identityToken,t.getIdentityToken,t.chatSurface),t.strings):new e.C(t.apiBaseUrl,t.token,t.gifApiKey,t.analyticsContextToken,{agentName:t.agentName,agentAvatarUrl:t.agentAvatarUrl},t.identityToken,t.getIdentityToken,t.chatSurface);exports.ResultTable=e.m,exports.WidgetAnalyticsChart=e._,exports.buildWidgetAnalyticsChartModel=e.v,exports.createChatTransport=t,exports.createPreferredAudioRecorder=e.u,exports.createVoiceAudioConstraints=e.d,exports.formatResultCell=e.h,exports.renderRich=e.a,exports.resolveConfig=e.t,exports.serializeResultCsv=e.g,exports.stopRecorderWithFlush=e.f,exports.useChat=e.n;
+const e=require(`./styles-BH7P8Q_3.cjs`),t=(e,n)=>{let r=e.replace(/\/\*[\s\S]*?\*\//g,``),i=e=>n.some(t=>e.includes(t)),a=[],o=0;for(;o<r.length;){let e=r.indexOf(`{`,o);if(e<0)break;let s=r.slice(o,e).trim(),c=1,l=e+1;for(;l<r.length&&c>0;)r[l]===`{`?c++:r[l]===`}`&&c--,l++;let u=r.slice(e+1,l-1);if(s.startsWith(`@`))if(/^@(media|supports|container)\b/.test(s)){let e=t(u,n);e&&a.push(`${s} {\n${e}\n}`)}else /^@keyframes\b/.test(s)&&i(s)&&a.push(`${s} {${u}}`);else i(s)&&a.push(`${s} {${u}}`);o=l}return a.join(`
+`)},n=(t,n,r)=>e.W(t,n,r),r=t(e.t,[`.cf-action`,`.cf-form`,`.cf-booking`]);exports.ActionsArea=e._,exports.ResultTable=e.G,exports.StringsProvider=e.z,exports.WIDGET_ACTION_STYLES=r,exports.WidgetAnalyticsChart=e.J,exports.analyticsResultDetails=n,exports.buildWidgetAnalyticsChartModel=e.Y,exports.createAdaptiveVoiceActivityDetector=e.o,exports.createChatTransport=e.X,exports.createPreferredAudioRecorder=e.s,exports.createVoiceAudioConstraints=e.c,exports.findLiveSupportAction=e.r,exports.formatResultCell=e.K,exports.looksLikeEcho=e.f,exports.reconnectableHandbackId=e.i,exports.renderRich=e.D,exports.resolveConfig=e.n,exports.selectStyleRules=t,exports.serializeResultCsv=e.q,exports.stopRecorderWithFlush=e.l,exports.usableTranscript=e.g,exports.useChat=e.a;

package/dist/runtime.d.cts

@@ -1,42 +1,38 @@
-import { _ as PublicChatActionField, a as Source, c as WidgetConfig, d as WidgetUser, f as ActionResult, g as PublicChatAction, h as GifResult, i as FeaturedLink, m as DemoSlotsResult, n as ChatArtifact, o as Visitor, p as AnalyticsVisualization, r as ChatMessage, s as WidgetActionTranslation, t as BootstrapInfo, u as WidgetThemeTokens, v as Transport, y as WidgetStrings } from "./types-B0r4SXaT.cjs";
-import * as preact0 from "preact";
+import { C as StringsProvider, D as AnalyticsExplanationInput, E as AnalyticsAIExplanationTransport, O as AnalyticsGroupComparisonPoint, S as Transport, T as ResultLabels, _ as DemoSlotsResult, a as MessageAttachment, b as PublicChatAction, c as Visitor, f as WidgetThemeTokens, g as DemoBooking, h as AnalyticsVisualization, i as FeaturedLink, k as AnalyticsPeriodComparison, l as WidgetActionTranslation, m as ActionResult, n as ChatArtifact, o as SchedulerInfo, p as WidgetUser, r as ChatMessage, s as Source, t as BootstrapInfo, u as WidgetConfig, v as ExplanationFeedbackInput, w as WidgetStrings, x as PublicChatActionField, y as GifResult } from "./types-CYFMH8yg.cjs";
+import * as preact1 from "preact";
 import { JSX } from "preact";
 
-//#region src/config.d.ts
-interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onAction' | 'onHandoff'>> {
-  accentColor?: string;
-  agentName?: string;
-  agentAvatarUrl?: string;
-  launcherIcon?: string;
-  themeTokens?: WidgetConfig['themeTokens'];
-  gifApiKey?: string;
-  /** Resolved string table (English defaults + host `labels` overrides). */
-  strings: WidgetStrings;
-  locale: string;
-  actionTranslations: Record<string, WidgetActionTranslation>;
-  /** Host-app SSO passthrough (see WidgetConfig.user). Optional. */
-  user?: WidgetConfig['user'];
-  /** Short-lived signed context for governed customer analytics. */
-  analyticsContextToken?: WidgetConfig['analyticsContextToken'];
-  identityToken?: WidgetConfig['identityToken'];
-  getIdentityToken?: WidgetConfig['getIdentityToken'];
-  customLauncherSelector?: string;
-  proactiveMessage?: string;
-  proactiveOnPaths?: string[];
-  onOpen?: WidgetConfig['onOpen'];
-  onClose?: WidgetConfig['onClose'];
-  onShow?: WidgetConfig['onShow'];
-  onHide?: WidgetConfig['onHide'];
-  onUnreadChange?: WidgetConfig['onUnreadChange'];
-  onMessage?: WidgetConfig['onMessage'];
-  onAction?: WidgetConfig['onAction'];
-  onHandoff?: WidgetConfig['onHandoff'];
-}
-declare const resolveConfig: (cfg: WidgetConfig) => ResolvedConfig;
-//#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/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 {
   key: string;
@@ -44,8 +40,11 @@ interface AnalyticsVisualizationColumn {
   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;
   description?: string;
   priority?: 'primary' | 'secondary' | 'detail';
   sortable?: boolean;
@@ -65,6 +64,10 @@ interface AnalyticsVisualizationRecommendation {
   confidence?: number;
 }
 interface 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';
@@ -81,6 +84,31 @@ interface AnalyticsVisualization$1 {
   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[];
   currency?: {
     code?: string;
@@ -95,6 +123,8 @@ interface ResultColumn {
   label?: string;
   dataType?: AnalyticsVisualizationColumn['dataType'];
   currencyCode?: string;
+  formatPattern?: string;
+  grain?: ResultGrain;
 }
 interface ResultTableClassNames {
   wrap?: string;
@@ -108,6 +138,8 @@ type WidgetAnalyticsSeries = {
   name: string;
   values: Array<number | null>;
   valueColumn?: AnalyticsVisualizationColumn;
+  /** Like-for-like breakdown: per-point comparison (tooltip detail). */
+  points?: Array<AnalyticsGroupComparisonPoint | undefined>;
 };
 type WidgetAnalyticsChartType = 'line' | 'bar' | 'stacked_bar';
 type WidgetAnalyticsChartModel = {
@@ -119,18 +151,34 @@ type WidgetAnalyticsChartModel = {
   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;
 };
-declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType) => WidgetAnalyticsChartModel | null;
+type WidgetAnalyticsChartOptions = {
+  locale?: string;
+  labels?: Partial<ResultLabels>;
+};
+declare const buildWidgetAnalyticsChartModel: (visualization: AnalyticsVisualization$1, overrideType?: WidgetAnalyticsChartType, options?: WidgetAnalyticsChartOptions) => WidgetAnalyticsChartModel | null;
 declare const WidgetAnalyticsChart: ({
   model,
-  expanded
+  expanded,
+  classPrefix: p
 }: {
   model: WidgetAnalyticsChartModel;
   expanded?: boolean;
-}) => preact0.JSX.Element;
+  /** Class prefix of the surface (`cf` widget, `ca` chat app). */
+  classPrefix?: string;
+}) => preact1.JSX.Element;
 //#endregion
 //#region ../centrinfo-results/src/result.d.ts
-declare const formatResultCell: (value: unknown, locale?: string, column?: ResultColumn) => string;
+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
@@ -139,6 +187,8 @@ interface ResultTableProps {
   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;
@@ -148,30 +198,66 @@ declare const ResultTable: ({
   columns,
   maxRows,
   locale,
+  format,
   expanded,
   classNames,
   emptyLabel
-}: ResultTableProps) => preact0.JSX.Element;
+}: ResultTableProps) => preact1.JSX.Element;
 //#endregion
-//#region src/rich.d.ts
-declare const renderRich: (text: string) => JSX.Element[];
+//#region ../centrinfo-results/src/result-details.d.ts
+interface AnalyticsResultDetail {
+  label: string;
+  value: string;
+}
 //#endregion
-//#region src/audio.d.ts
-interface VoiceAudioCapabilities {
-  echoCancellation?: boolean;
-  noiseSuppression?: boolean;
-  autoGainControl?: boolean;
-  channelCount?: boolean;
-  voiceIsolation?: boolean;
+//#region src/config.d.ts
+interface ResolvedConfig extends Required<Omit<WidgetConfig, 'accentColor' | 'agentName' | 'agentAvatarUrl' | 'launcherIcon' | 'themeTokens' | 'gifApiKey' | 'labels' | 'locale' | 'dir' | 'translations' | 'user' | 'analyticsContextToken' | 'identityToken' | 'getIdentityToken' | 'customLauncherSelector' | 'proactiveMessage' | 'proactiveOnPaths' | 'onOpen' | 'onClose' | 'onShow' | 'onHide' | 'onUnreadChange' | 'onMessage' | 'onOpenAnalyticsSource' | 'onAction' | 'onHandoff'>> {
+  accentColor?: string;
+  agentName?: string;
+  agentAvatarUrl?: string;
+  launcherIcon?: string;
+  themeTokens?: WidgetConfig['themeTokens'];
+  gifApiKey?: string;
+  /** Resolved string table (English defaults + host `labels` overrides). */
+  strings: WidgetStrings;
+  locale: string;
+  /** Resolved text direction (from `dir`, else the locale). */
+  dir: 'ltr' | 'rtl';
+  actionTranslations: Record<string, WidgetActionTranslation>;
+  /** Host-app SSO passthrough (see WidgetConfig.user). Optional. */
+  user?: WidgetConfig['user'];
+  /** Short-lived signed context for governed customer analytics. */
+  analyticsContextToken?: WidgetConfig['analyticsContextToken'];
+  identityToken?: WidgetConfig['identityToken'];
+  getIdentityToken?: WidgetConfig['getIdentityToken'];
+  customLauncherSelector?: string;
+  proactiveMessage?: string;
+  proactiveOnPaths?: string[];
+  onOpen?: WidgetConfig['onOpen'];
+  onClose?: WidgetConfig['onClose'];
+  onShow?: WidgetConfig['onShow'];
+  onHide?: WidgetConfig['onHide'];
+  onUnreadChange?: WidgetConfig['onUnreadChange'];
+  onMessage?: WidgetConfig['onMessage'];
+  onOpenAnalyticsSource?: WidgetConfig['onOpenAnalyticsSource'];
+  onAction?: WidgetConfig['onAction'];
+  onHandoff?: WidgetConfig['onHandoff'];
 }
+declare const resolveConfig: (cfg: WidgetConfig) => ResolvedConfig;
+//#endregion
+//#region src/api/factory.d.ts
 /**
- * Build a best-effort microphone profile for conversational speech. Every
- * enhancement is capability-driven and optional, so unsupported processing
- * cannot make microphone permission fail.
+ * The real client is bundled; the demo and preview transports are fetched the
+ * first time they are used, so production widgets never download them.
  */
-declare const createVoiceAudioConstraints: (deviceId?: string, supported?: VoiceAudioCapabilities) => MediaTrackConstraints;
-declare const createPreferredAudioRecorder: (stream: MediaStream) => MediaRecorder;
-declare const stopRecorderWithFlush: (recorder: MediaRecorder | null | undefined) => void;
+declare const createChatTransport: (config: ResolvedConfig) => Transport;
+//#endregion
+//#region src/rich.d.ts
+declare const renderRich: (text: string) => JSX.Element[];
+//#endregion
+//#region src/result-details.d.ts
+/** Reader-safe result context shared by the floating widget and chat app. */
+declare const analyticsResultDetails: (result: AnalyticsVisualization, labels?: Partial<ResultLabels>, locale?: string) => AnalyticsResultDetail[];
 //#endregion
 //#region src/useChat.d.ts
 /** One past conversation, for the in-widget history list. */
@@ -183,7 +269,18 @@ interface HistoryEntry {
   title: string;
   ended: boolean;
 }
+/** The catalogue action that brings a teammate into the chat, when usable.
+ *  A backend older than the liveHandoff flag is recognised by its fixed id. */
+declare const findLiveSupportAction: (actions: PublicChatAction[] | undefined) => PublicChatAction | undefined;
+/** The ai_handback notice that may still offer to reconnect: the latest one,
+ *  while the AI has the chat and the visitor has not already asked again. */
+declare const reconnectableHandbackId: (messages: ChatMessage[], liveMode: "ai" | "queued" | "human") => string | undefined;
 /** Optional extras when sending — an inline image (GIF) or an extracted file. */
+interface VoiceReply {
+  status: 'idle' | 'answering' | 'speaking' | 'done' | 'failed';
+  /** The assistant message answering the voice turn. */
+  agentId?: string;
+}
 interface SendOpts {
   imageUrl?: string;
   /** Voice-call turns should speak the assistant reply using provider TTS when configured. */
@@ -194,6 +291,19 @@ interface SendOpts {
   attachmentName?: string;
   /** Text extracted from the attachment, folded into the backend question. */
   attachmentText?: string;
+  attachmentId?: string;
+  /** The attached file itself, kept in memory so it can be previewed. */
+  attachmentFile?: Blob;
+  /** Several files sent with the message (replaces the single fields). */
+  attachments?: OutgoingAttachment[];
+}
+interface OutgoingAttachment {
+  id?: string;
+  name: string;
+  /** Text extracted from the file, folded into the backend question. */
+  text?: string;
+  /** Kept in memory so it can be previewed. */
+  file?: Blob;
 }
 interface ChatApi {
   persona: BootstrapInfo | null;
@@ -201,6 +311,12 @@ interface ChatApi {
   sending: boolean;
   /** True while a TTS reply audio element is actively playing. */
   assistantSpeaking: boolean;
+  /** Progress of the answer to the latest voice turn (a send or retry with
+   * forceVoicePlayback): answering until its audio starts, speaking while it
+   * plays, then done — or failed when the request failed. Done is only set
+   * once playback has ended or there was nothing to play, so a caller can
+   * safely reopen the microphone. */
+  voiceReply: VoiceReply;
   visitor: Visitor;
   /** Effective starter prompts: host `starters` if set, else token `starterQuestions`. */
   starters: string[];
@@ -215,17 +331,42 @@ interface ChatApi {
   /** Human currently typing in the live chat, if any. */
   agentTypingName?: string;
   send: (text: string, opts?: SendOpts) => void;
+  /** Add to the question being answered (the visitor kept talking while the
+   * reply was prepared): cancels that reply and asks again with all of it.
+   * Also completes a held question (see `hold`). An ordinary send otherwise. */
+  amend: (text: string, opts?: SendOpts) => void;
+  /** The visitor started talking while the reply was prepared: cancel it now
+   * (so its audio never plays over them) but keep the question, to be asked
+   * again by `amend` with their words, or by `resumeHeld` if it was noise.
+   * Returns false when nothing was in flight. */
+  hold: () => boolean;
+  /** Ask a held question again, unchanged (what was heard was not speech). */
+  resumeHeld: () => void;
+  /** Lower (true) or restore (false) the reply being read aloud, while the
+   * visitor may be talking over it: it keeps playing until we know whether
+   * that was the visitor or the reply's own echo. */
+  duckSpeaking: (ducked: boolean) => void;
   sendGif: (url: string) => void;
   /** Soft visitor typing hint for the staff console. */
   notifyTyping: (isTyping: boolean) => void;
   /** Cancel the in-flight streaming reply (Stop button). */
   stop: () => void;
   /** Re-run a failed turn in place. */
-  retry: (agentId: string, question: string) => void;
+  retry: (agentId: string, question: string, opts?: Pick<SendOpts, 'forceVoicePlayback'>) => void;
   /** Record a 👍/👎 on an assistant reply (optional comment on 👎). Optimistic. */
   rateMessage: (messageId: string, rating: 'up' | 'down', comment?: string) => void;
+  /** Record a vote on an analytics explanation. Rejects when it could not be
+   *  saved (or the transport has no explanation feedback) so the UI can retry. */
+  rateExplanation: (input: Omit<ExplanationFeedbackInput, 'sessionId' | 'surface'>, surface?: ExplanationFeedbackInput['surface']) => Promise<void>;
+  /** Poll / retry the detailed AI explanation of an analytics answer for this
+   *  session; undefined when the transport cannot. */
+  explanationTransport: (surface?: ExplanationFeedbackInput['surface']) => AnalyticsAIExplanationTransport<AnalyticsExplanationInput> | undefined;
   /** Append a proactive assistant message (auto-engagement). No-op duplicate-guarded. */
   injectAssistant: (content: string) => void;
+  /** After a teammate handed the chat back to the AI: offer the live-support
+   *  action again (its form opens in the conversation). False when this
+   *  widget has no live-support action. */
+  reconnectSupport: () => boolean;
   /** Add/update/remove local-only bubbles used by the live voice capture UI. */
   appendUserDraft: (content: string) => string;
   patchMessage: (id: string, fields: Partial<ChatMessage>) => void;
@@ -235,9 +376,15 @@ interface ChatApi {
   /** Submit an inline action form; persists identity so Case-1 auto-handoff can fire later. */
   submitForm: (type: string, payload: Record<string, unknown>, identity?: Visitor, /** Backend-declared endpoint; authoritative when present. */
   endpointOverride?: string) => Promise<ActionResult>;
+  confirmHostedBooking: (inquiryId: string, eventUri: string, inviteeUri: string) => Promise<DemoBooking | undefined>;
   transcribe: (audio: Blob | string, mimeType: string, languageHint?: string, durationSeconds?: number) => Promise<string>;
-  /** Extract text from an attached image/PDF (folded into the next message). */
-  extract: (fileBase64: string, mimeType: string, filename?: string) => Promise<string>;
+  uploadAttachment: (fileBase64: string, mimeType: string, filename: string, analyze: boolean) => Promise<{
+    id: string;
+    text: string;
+    analysisFailed: boolean;
+  }>;
+  /** The file attached to a visitor message, for preview. */
+  loadAttachment: (message: Pick<ChatMessage, 'id'>, attachment: MessageAttachment, index?: number) => Promise<Blob>;
   searchGifs: (query: string) => Promise<GifResult[]>;
   /** Booking availability in a window (booked slots + connected-calendar busy ranges). */
   demoSlots: (fromISO: string, toISO: string) => Promise<DemoSlotsResult>;
@@ -272,7 +419,116 @@ interface ChatApi {
 }
 declare const useChat: (transport: Transport, config: ResolvedConfig, active?: boolean) => ChatApi;
 //#endregion
+//#region src/components.d.ts
+/** Submit handler shared by the forms + handoff card. */
+type SubmitForm = (type: string, payload: Record<string, unknown>, identity?: Visitor, /** Backend-declared endpoint; authoritative when present. */
+endpointOverride?: string) => Promise<ActionResult>;
+type ConfirmHostedBooking = (inquiryId: string, eventUri: string, inviteeUri: string) => Promise<DemoBooking | undefined>;
+declare const ActionsArea: ({
+  actions,
+  descriptors,
+  visitor,
+  onSubmitForm,
+  onDemoSlots,
+  onConfirmHostedBooking,
+  scheduler,
+  exclude,
+  openAction,
+  translations,
+  onClose
+}: {
+  /** Legacy tool ids. Used only when `descriptors` is absent (older backend). */
+  actions?: string[];
+  /** Structured descriptors — preferred. */
+  descriptors?: PublicChatAction[];
+  visitor: Visitor;
+  onSubmitForm: SubmitForm;
+  onDemoSlots?: (fromISO: string, toISO: string) => Promise<DemoSlotsResult>;
+  onConfirmHostedBooking?: ConfirmHostedBooking;
+  scheduler?: SchedulerInfo;
+  exclude?: string[];
+  /** Action id the backend resolved for this turn — opens its form directly. */
+  openAction?: string;
+  /** Locale-specific copy keyed by stable action ID. */
+  translations?: Record<string, WidgetActionTranslation>;
+  /** A host that shows the actions in its own panel: closing or cancelling
+   *  the action closes that panel instead of returning to the action menu. */
+  onClose?: () => void;
+}) => JSX.Element | null;
+//#endregion
+//#region src/style-rules.d.ts
+/**
+ * Picks the rules for some components out of a stylesheet, so another
+ * surface can render those components without the whole widget stylesheet.
+ *
+ * A rule is kept when its selector names one of the class prefixes; at-rules
+ * such as @media keep only their matching inner rules and are dropped when
+ * none match. Comments are removed. This is a small parser for our own,
+ * well-formed stylesheet — not a general CSS parser.
+ */
+declare const selectStyleRules: (css: string, classPrefixes: string[]) => string;
+//#endregion
+//#region src/transcript.d.ts
+/** A transcript worth sending as the visitor's turn: annotations stripped,
+ * and neither noise, silence nor a leaked transcription prompt. Returns ''
+ * when there is nothing to send. */
+declare const usableTranscript: (text: string) => string;
+/** The microphone picked up the AI's own reply from the speakers, not the
+ * visitor (shared with every voice surface). */
+declare const looksLikeEcho: (transcript: string, spoken: string) => boolean;
+//#endregion
+//#region src/audio.d.ts
+interface VoiceAudioCapabilities {
+  echoCancellation?: boolean;
+  noiseSuppression?: boolean;
+  autoGainControl?: boolean;
+  channelCount?: boolean;
+  voiceIsolation?: boolean;
+}
+/**
+ * Build a best-effort microphone profile for conversational speech. Every
+ * enhancement is capability-driven and optional, so unsupported processing
+ * cannot make microphone permission fail.
+ */
+declare const createVoiceAudioConstraints: (deviceId?: string, supported?: VoiceAudioCapabilities) => MediaTrackConstraints;
+interface AdaptiveVoiceActivityOptions {
+  calibrationSamples?: number;
+  ambientWindowSamples?: number;
+  ambientPercentile?: number;
+  smoothing?: number;
+  minimumNoiseFloor?: number;
+  speechToNoiseRatio?: number;
+  quietToNoiseRatio?: number;
+  minimumEndSilenceMs?: number;
+  maximumEndSilenceMs?: number;
+}
+interface VoiceActivitySample {
+  speech: boolean;
+  quiet: boolean;
+  calibrated: boolean;
+  noiseFloor: number;
+  speechThreshold: number;
+  quietThreshold: number;
+  endOfSpeechDelayMs: number;
+}
+/**
+ * Learn the room's ambient level continuously and classify relative changes.
+ * The detector is synchronous and runs on samples already collected for the
+ * level meter, so it adds no network request or post-recording delay.
+ */
+declare const createAdaptiveVoiceActivityDetector: (options?: AdaptiveVoiceActivityOptions) => {
+  observe: (rms: number) => VoiceActivitySample;
+  reset: () => void;
+};
+declare const createPreferredAudioRecorder: (stream: MediaStream) => MediaRecorder;
+declare const stopRecorderWithFlush: (recorder: MediaRecorder | null | undefined) => void;
+//#endregion
 //#region src/runtime.d.ts
-declare const createChatTransport: (config: ResolvedConfig) => Transport;
+/**
+ * The widget's action buttons, forms and booking picker, for surfaces that
+ * render ActionsArea. They read the --cf-* theme variables, which the host
+ * surface maps onto its own theme.
+ */
+declare const WIDGET_ACTION_STYLES: string;
 //#endregion
-export { type ActionResult, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, type Transport, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, buildWidgetAnalyticsChartModel, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, formatResultCell, renderRich, resolveConfig, serializeResultCsv, stopRecorderWithFlush, useChat };
+export { type ActionResult, ActionsArea, type AnalyticsVisualization, type BootstrapInfo, type ChatApi, type ChatArtifact, type ChatMessage, type DemoSlotsResult, type HistoryEntry, type MessageAttachment, type PublicChatAction, type PublicChatActionField, type ResolvedConfig, ResultTable, type Source, StringsProvider, type Transport, type VoiceReply, WIDGET_ACTION_STYLES, WidgetAnalyticsChart, type WidgetConfig, type WidgetThemeTokens, type WidgetUser, analyticsResultDetails, buildWidgetAnalyticsChartModel, createAdaptiveVoiceActivityDetector, createChatTransport, createPreferredAudioRecorder, createVoiceAudioConstraints, findLiveSupportAction, formatResultCell, looksLikeEcho, reconnectableHandbackId, renderRich, resolveConfig, selectStyleRules, serializeResultCsv, stopRecorderWithFlush, usableTranscript, useChat };