@sapia-ai/chatbot-v3 1.5.0 → 1.6.0

package/dist/core/bubbles/cards.d.ts

@@ -8,7 +8,9 @@ export declare enum BubbleCard {
     PII_FORM_INTRO = "PII_FORM_INTRO",
     PII_DETAILS = "PII_DETAILS",
     CUSTOMER_SATISFACTION_FORM = "CUSTOMER_SATISFACTION_FORM",
-    CUSTOMER_SATISFACTION_INTRO = "CUSTOMER_SATISFACTION_INTRO"
+    CUSTOMER_SATISFACTION_INTRO = "CUSTOMER_SATISFACTION_INTRO",
+    DEMOGRAPHIC_FORM = "DEMOGRAPHIC_FORM",
+    DEMOGRAPHIC_DETAILS = "DEMOGRAPHIC_DETAILS"
 }
 /**
  * The card this content bubble stands for, or undefined for ordinary text. The backend's

package/dist/core/bubbles/demographicRun.d.ts

@@ -0,0 +1,57 @@
+import { MCQQuestionOption } from '../../api/types/messages';
+import { ChatLog, DemographicFormField } from '../../api/types/responses';
+import { BubbleStatus, MessageBubble } from './types';
+/** Id prefix of the synthetic candidate turn the card is answered in. */
+export declare const DEI_FORM_BUBBLE_ID_PREFIX = "dei-form";
+/** Id prefix of the candidate turn standing in for an answered run. */
+export declare const DEI_DETAILS_BUBBLE_ID_PREFIX = "dei-details";
+/** The option ids ticked on the card, keyed by questionId, before it is posted. */
+export type DemographicAnswers = Record<string, string[]>;
+/**
+ * Replace the prompt the diversity run opens on — and the inline option list it would have drawn —
+ * with the card's placeholder turn. The run's own prompts are the card's field labels, so none of
+ * them reaches the transcript as a message; the template's intro hints above stay as they are and
+ * the card reads as the reply to them.
+ *
+ * Applied on the live stream. A transcript that does not hold the run's opening prompt is returned
+ * unchanged, which also makes re-marking after the prompt is gone a no-op.
+ *
+ * @example
+ * ```js
+ * // bubbles: [...hints, agent(gender), candidateInline(gender)]; fields start at gender
+ * markDemographicFormBubble(bubbles, fields) // [...hints, formBubble(candidate)]
+ * ```
+ */
+export declare const markDemographicFormBubble: (bubbles: MessageBubble[], fields?: DemographicFormField[]) => MessageBubble[];
+/**
+ * The options ticked for each question, in dialogue order. A question with nothing ticked is
+ * absent, and an id the question never offered is dropped rather than posted.
+ */
+export declare const demographicSelections: (fields: DemographicFormField[], answers: DemographicAnswers) => {
+    field: DemographicFormField;
+    options: MCQQuestionOption[];
+}[];
+/**
+ * Draw the halves of a diversity run the backend folded a reloaded transcript into. The form
+ * message becomes the card while the run is still open, and nothing once it has been answered; the
+ * responses message becomes the answered card.
+ *
+ * @returns the bubbles for a folded half, or undefined for any other turn
+ * @example
+ * ```js
+ * // chatLogs: [{formType, fields}, {formType, responses: [{prompt: "Gender", answer: "Woman"}]}]
+ * demographicRunBubbles(chatLogs[0], chatLogs[1]) // []
+ * demographicRunBubbles(chatLogs[1])              // [answered card: Gender — Woman]
+ * ```
+ */
+export declare const demographicRunBubbles: (chatLog: ChatLog, nextChatLog?: ChatLog) => MessageBubble[] | undefined;
+/**
+ * The diversity run a reloaded transcript is still waiting on, so the engine can redraw the card.
+ * A run that has been posted comes back with its responses beside it and needs no card.
+ */
+export declare const openDemographicForm: (chatLogs: ChatLog[]) => DemographicFormField[] | undefined;
+/** Swap the card's placeholder turn for the answered card, built from the same answers. */
+export declare const swapFormForDemographicDetails: (bubbles: MessageBubble[], fields: DemographicFormField[], answers: DemographicAnswers, status: BubbleStatus) => {
+    bubbles: MessageBubble[];
+    detailsBubbleId: string;
+};

package/dist/core/bubbles/selection.d.ts

@@ -1,4 +1,4 @@
-import { QuestionRule } from '../../api/types/messages';
+import { QuestionType, QuestionRule } from '../../api/types/messages';
 import { MessageBubble } from './types';
 /** Which instruction a multi-select question shows above its options. */
 export declare enum SelectionInstruction {
@@ -32,6 +32,8 @@ export declare const usesSelectionAnswer: (bubble: MessageBubble) => boolean;
  * multi-select path, even though its answer still goes over the wire as a set of one.
  */
 export declare const isMultiSelectBubble: (bubble: MessageBubble) => boolean;
+/** @see isMultiSelectBubble — the same rule for a question described outside a bubble. */
+export declare const isMultiSelectQuestion: (types: QuestionType[], rules?: QuestionRule[]) => boolean;
 /**
  * Which instruction the question shows. A cap equal to the number of options on offer states
  * nothing "any number" does not already allow, so it reads as open-ended — the builder never offers

package/dist/core/bubbles/types.d.ts

@@ -83,6 +83,15 @@ export type CustomerSatisfactionResponse = {
     rating?: number;
     comment?: string;
 };
+/**
+ * One answered diversity question as the answered card draws it: the template's question and what
+ * the candidate chose, already joined for display.
+ */
+export type DemographicDetailEntry = {
+    questionId: string;
+    prompt: string;
+    answer: string;
+};
 export type MessageBubbleData = {
     messageItems: MessageItem[];
     answer?: AnswerContent | null;
@@ -92,6 +101,8 @@ export type MessageBubbleData = {
     piiDetails?: PiiDetailEntry[];
     /** Present only on the bubble standing in for an answered feedback run. */
     customerSatisfaction?: CustomerSatisfactionResponse;
+    /** Present only on the bubble standing in for an answered diversity run. */
+    demographicDetails?: DemographicDetailEntry[];
 };
 export type MessageBubble = {
     status: BubbleStatus;

package/dist/core/interview/engine.d.ts

@@ -3,6 +3,7 @@ import { PiiSubmitOutcome } from '../validation/piiAnswer';
 import { PiiFormAnswer } from '../validation/piiForm';
 import { LocationAnswer } from '../../api/places';
 import { CustomerSatisfactionAnswer } from '../bubbles/customerSatisfactionRun';
+import { DemographicAnswers } from '../bubbles/demographicRun';
 import { ChatbotEventEmitter } from '../events';
 import { InterviewStore } from '../store';
 export type InterviewEngineDeps = {
@@ -18,6 +19,12 @@ export type InterviewEngineDeps = {
     welcomeGate?: boolean;
     /** Reveal cadence (ms per character) while streaming; 0 reveals each chunk wholesale (reduced-motion). */
     streamRevealMs?: number;
+    /**
+     * Stream agent text word by word (true), or have the backend send each message whole and paint
+     * it whole (false, the default). Questions are predefined and the same for every candidate, so
+     * by default they must not look generated as they arrive.
+     */
+    streamText?: boolean;
 };
 export declare class InterviewEngine {
     private readonly client;
@@ -29,6 +36,7 @@ export declare class InterviewEngine {
     private language;
     private readonly welcomeGate;
     private readonly streamRevealMs;
+    private readonly streamText;
     /** Aborts the in-flight stream when a new load starts. */
     private streamAbort?;
     /** Monotonic counter for unique live-bubble ids (avoids Date.now in core). */
@@ -134,6 +142,12 @@ export declare class InterviewEngine {
     private submitResolved;
     /** Submit the name value the candidate confirmed in the extraction modal. */
     submitNameConfirmed(text: string): Promise<void>;
+    /**
+     * Keeps the name the candidate just gave so the done screen can greet them without another
+     * /start/ats. Shown exactly as typed — a full name is never split. A first name wins: a full
+     * name only fills the slot when nothing better is known yet.
+     */
+    private rememberCandidateName;
     /**
      * Submit a location PII answer (legacy handleSelectLocation). The value must be JSON: the backend
      * parses it before reading `address`/`coordinate`, so a bare address string fails the request.
@@ -173,6 +187,23 @@ export declare class InterviewEngine {
      * ```
      */
     submitCustomerSatisfactionForm(answer: CustomerSatisfactionAnswer): Promise<void>;
+    /**
+     * Post the diversity card. Answers go in dialogue order because the backend replays them one at a
+     * time against the prompt it has open. A multi-select answer travels as its selections whatever
+     * its cap, as it does everywhere else. The card is only sendable once every question carries an
+     * answer; that is checked again here so a stale click can never post a partial card.
+     *
+     * The card becomes the answered card before the request goes out; a failed send leaves it FAILED
+     * and retryLastAnswer re-posts the same answers.
+     *
+     * @example
+     * ```js
+     * // fields: [gender(MCQ), ethnicity(MSQ)]
+     * submitDemographicForm({ gender: ['woman'], ethnicity: ['asian', 'pacific'] })
+     * // posts [{ text: 'Woman' }, { text: 'Asian | Pacific', selections: [...] }]
+     * ```
+     */
+    submitDemographicForm(answers: DemographicAnswers): Promise<void>;
     /**
      * Re-edit a previously answered question (legacy EDIT_MODE_ENTER): mark its
      * candidate bubble EDITING so the input/options re-appear; the next submit
@@ -270,8 +301,8 @@ export declare class InterviewEngine {
     private replacePendingBubble;
     /**
      * Loads the next message via /next/stream (the sole load path): consumes the
-     * AG-UI stream, revealing agent text word-by-word into a transient live bubble,
-     * then swaps it for the authoritative bubble from the terminal RUN_FINISHED
+     * AG-UI stream into a transient live bubble (painted whole, or word by word when streamText
+     * is on), then swaps it for the authoritative bubble from the terminal RUN_FINISHED
      * frame. Shares the candidate-settle and agent-append tails with the answer flow.
      */
     private loadNext;

package/dist/core/interview/reveal.d.ts

@@ -20,9 +20,10 @@ export type StreamPaint = {
 /**
  * A run can bundle several messages: each carries its own message id, and a new id means the
  * previous one is finished and must be frozen as a hint — only the final message is echoed
- * authoritatively in RUN_FINISHED. This owns that segmentation and the word-by-word cadence.
+ * authoritatively in RUN_FINISHED. This owns that segmentation and how each message is revealed: whole, or word by word.
  */
 export declare class StreamAssembler {
+    /** Ms per character for the word-by-word reveal; undefined paints each message whole. */
     private readonly revealMs;
     private readonly nextSyntheticId;
     private readonly paint;
@@ -46,7 +47,9 @@ export declare class StreamAssembler {
     private readonly metaById;
     private networkDone;
     private placed;
-    constructor(revealMs: number, nextSyntheticId: () => string, paint: StreamPaint);
+    constructor(
+    /** Ms per character for the word-by-word reveal; undefined paints each message whole. */
+    revealMs: number | undefined, nextSyntheticId: () => string, paint: StreamPaint);
     /** Id the live bubble is painted under — the backend's own once a delta has named it. */
     get liveId(): string;
     /** Backend message id of the message currently streaming; undefined before the first delta. */

package/dist/core/store.d.ts

@@ -1,7 +1,7 @@
 import { StoreApi } from 'zustand/vanilla';
 import { AssessmentStatus } from '../api/types/messages';
 import { Branding } from '../api/types/branding';
-import { AssessmentSummary, CustomerSatisfactionFormField, PiiFormField, ResolvedFeatureFlags } from '../api/types/responses';
+import { AssessmentSummary, CustomerSatisfactionFormField, DemographicFormField, PiiFormField, ResolvedFeatureFlags } from '../api/types/responses';
 import { PiiFormAnswer } from './validation/piiForm';
 import { MessageBubble } from './bubbles/types';
 export declare enum InterviewPhase {
@@ -62,8 +62,16 @@ export type InterviewState = {
      * CUSTOMER_SATISFACTION_FORM frame and from /start on reload; cleared once the card is posted.
      */
     csatForm?: CustomerSatisfactionFormField[];
+    /**
+     * The diversity questions the interview is paused on, in dialogue order. Set from the
+     * DEMOGRAPHIC_FORM frame and from /start on reload; cleared once the card is posted.
+     */
+    deiForm?: DemographicFormField[];
     branding?: Branding;
-    /** Candidate display name for the welcome/done screens (optional; from /start/ats). */
+    /**
+     * Name the welcome and done screens greet the candidate by: /start/ats's first name, or the
+     * name given in this session's PII step. Absent → generic copy.
+     */
     candidateName?: string;
     /** Cohort title from /start/ats, shown as the role in the header and welcome. */
     jobTitle?: string;

package/dist/core/theme/branding.d.ts

@@ -1,6 +1,9 @@
 import { Branding } from '../../api/types/branding';
 import { Theme } from './types';
-/** Converts the branding payload (theme array + font) into a Theme object. */
-export declare const brandingToTheme: (branding?: Branding) => Theme;
+/**
+ * Converts the branding payload (theme array + font) into a Theme object. `assessmentId` only
+ * identifies the assessment in contrast warnings, since newer BEs no longer send `customerId`.
+ */
+export declare const brandingToTheme: (branding?: Branding, assessmentId?: string) => Theme;
 /** Merge two themes; `override` (host setTheme) wins per field over `base` (branding). */
 export declare const mergeThemes: (base: Theme | undefined, override: Theme | undefined) => Theme;

package/dist/{dist-Cl2Oi3Sl.js → dist-CoO0i-y0.js}

@@ -1,5 +1,5 @@
-import { B as e } from "./client-DfRBtXIE.js";
-import { t } from "./react-D4Z0N-x7.js";
+import { H as e } from "./client-C2MWNOYf.js";
+import { t } from "./react-wrZMUHWq.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { n as r, t as i } from "./hls-mBncGwsE.js";
 import { a, i as o, n as s, r as c, t as l } from "./classPrivateFieldSet2-DtQPURVD.js";
@@ -14324,4 +14324,4 @@ var Kw = Object.prototype.hasOwnProperty, qw = (e, t) => {
 //#endregion
 export { Or as MaxResolution, C as MediaError, kr as MinResolution, Ar as RenditionOrder, rT as default, ha as generatePlayerInitTime, nT as playerSoftwareName, tT as playerSoftwareVersion };
 
-//# sourceMappingURL=dist-Cl2Oi3Sl.js.map
+//# sourceMappingURL=dist-CoO0i-y0.js.map

package/dist/embed/createChatbot.d.ts

@@ -19,8 +19,6 @@ export type CreateChatbotOptions = {
     placesApiKey?: string;
     /** Custom fetch (e.g. a mocked SSE stream for demos/tests). */
     fetchImpl?: typeof fetch;
-    /** @internal Holds the typing indicator's "reading" phrase open (demos/tests). */
-    readingPhaseMs?: number;
 };
 export type Chatbot = {
     mount: (target?: string | HTMLElement) => void;

package/dist/{fix-webm-duration-CVQSf7rp.js → fix-webm-duration-CXijcUXq.js}

@@ -1,4 +1,4 @@
-import { R as e } from "./client-DfRBtXIE.js";
+import { B as e } from "./client-C2MWNOYf.js";
 //#region ../../node_modules/.pnpm/fix-webm-duration@1.0.6/node_modules/fix-webm-duration/fix-webm-duration.js
 var t = /* @__PURE__ */ e(((e, t) => {
 	(function(e, n) {
@@ -1054,4 +1054,4 @@ var t = /* @__PURE__ */ e(((e, t) => {
 //#endregion
 export default t();
 
-//# sourceMappingURL=fix-webm-duration-CVQSf7rp.js.map
+//# sourceMappingURL=fix-webm-duration-CXijcUXq.js.map