@sapia-ai/chatbot-v3 1.1.1 → 1.3.0

package/dist/{Preview-wPnYtccF.js → Preview-Dd7KyhMk.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-C00e82NS.js";
+import { t } from "./react-DkQKleWD.js";
 //#region ../../node_modules/.pnpm/react-player@3.4.0_@svta+cml-cta@1.0.6_@svta+cml-structured-field-values@1.1.3_@svta+cm_a4f64f295cc2a316f39ce360b0a6e480/node_modules/react-player/dist/Preview.js
 var n = /* @__PURE__ */ e(t(), 1), r = "64px", i = {}, a = ({ src: e, light: t, oEmbedUrl: a, onClickPreview: o, playIcon: s, previewTabIndex: c, previewAriaLabel: l }) => {
 	let [u, d] = (0, n.useState)(null);
@@ -81,4 +81,4 @@ var n = /* @__PURE__ */ e(t(), 1), r = "64px", i = {}, a = ({ src: e, light: t,
 //#endregion
 export { a as default };
 
-//# sourceMappingURL=Preview-wPnYtccF.js.map
+//# sourceMappingURL=Preview-Dd7KyhMk.js.map

package/dist/api/client.d.ts

@@ -18,10 +18,16 @@ export type NextStreamHandlers = {
      * bundled message (consecutive hints arrive as separate baseIds in one run).
      */
     onDelta: (text: string, messageId: string) => void;
-    /** Optional leading frame carrying the question structure (types/rules/options) before the text. */
-    onMeta?: (question: Question) => void;
-    /** The pre-interview "what to expect" summary, emitted once before any dialogue content. */
+    /**
+     * Optional leading frame carrying the question structure (types/rules/options) before the text.
+     * `messageId` is the baseId the following TEXT_MESSAGE_* frames prefix their ids with, so a
+     * caller buffering several bundled messages can pair each one with its own snapshot.
+     */
+    onMeta?: (question: Question, messageId: string) => void;
+    /** "What to expect" counts, emitted at the position of the summary bubble inside a message. */
     onSummary?: (summary: AssessmentSummary) => void;
+    /** The assessment's resume link, emitted at the position of the copy-link bubble. */
+    onLink?: (url: string) => void;
     /** Aborts the in-flight stream (new request / unmount). */
     signal?: AbortSignal;
 };
@@ -45,9 +51,7 @@ export declare class ChatbotApiClient {
      * `type`. Fires onMeta from STATE_SNAPSHOT and onDelta per TEXT_MESSAGE_CONTENT,
      * then resolves with the authoritative NextResponse carried by RUN_FINISHED.
      */
-    nextStream(assessmentId: string, candidateResponse: CandidateResponseInput | undefined, handlers: NextStreamHandlers, options?: {
-        summaryContinued?: boolean;
-    }): Promise<NextResponse | undefined>;
+    nextStream(assessmentId: string, candidateResponse: CandidateResponseInput | undefined, handlers: NextStreamHandlers): Promise<NextResponse | undefined>;
     editAnswer(assessmentId: string, editCandidateResponse: EditCandidateResponseInput): Promise<EditAnswerResponse>;
     extractHumanName(assessmentId: string, input: {
         userText: string;

package/dist/api/places.d.ts

@@ -0,0 +1,33 @@
+export type Coordinate = {
+    lat: number;
+    lng: number;
+};
+/** The answer value the backend parses for a location PII question. */
+export type LocationAnswer = {
+    address: string;
+    coordinate: Coordinate | null;
+};
+export type PlaceSuggestion = {
+    placeId: string;
+    /** Full prediction text, used as the accessible option label. */
+    description: string;
+    mainText: string;
+    secondaryText: string;
+};
+export type PlacesRequest = {
+    /** Host override; defaults to the key legacy ships. */
+    apiKey?: string;
+    signal?: AbortSignal;
+    /**
+     * Injected transport. Unit tests only — nothing in the app passes it, including the demo's
+     * offline mock, so a location question in `?stream=mock` makes real Places requests.
+     */
+    fetchImpl?: typeof fetch;
+};
+/** Address predictions for what the candidate has typed so far. */
+export declare const fetchPlaceSuggestions: (input: string, options?: PlacesRequest) => Promise<PlaceSuggestion[]>;
+/**
+ * Resolves a chosen prediction to the answer we store. Falls back to the prediction's own text when
+ * the details call returns no formatted address, so a selection never submits an empty address.
+ */
+export declare const fetchPlaceAnswer: (suggestion: PlaceSuggestion, options?: PlacesRequest) => Promise<LocationAnswer>;

package/dist/api/types/messages.d.ts

@@ -18,7 +18,9 @@ export declare enum QuestionType {
     VIDEO = "VIDEO",
     SLIDER = "SLIDER",
     DROPDOWN = "DROPDOWN",
-    BGQ = "BUTTON_GROUP_QUESTION"
+    BGQ = "BUTTON_GROUP_QUESTION",
+    /** Text the candidate acknowledges with a single button; carries no assessed answer. */
+    BREAK = "BREAK"
 }
 export declare enum ContentType {
     TEXT = "TEXT",
@@ -65,7 +67,23 @@ export declare enum AssessmentStatus {
     FI_PREDICTION_COMPLETED = "FI_PREDICTION_COMPLETED",
     FI_ASSESSMENT_DUPLICATED = "FI_ASSESSMENT_DUPLICATED"
 }
-export type MessageIdentifier = string;
+/**
+ * Backend message identifiers the widget branches on. The wire carries many more; only the ones
+ * with FE behaviour are enumerated, and the bubble field stays widened to `string` so unknown
+ * identifiers pass through untouched.
+ */
+export declare enum MessageIdentifier {
+    SMS_CONSENT_QUESTION = "SMS_CONSENT_QUESTION_MESSAGE",
+    SMS_CONSENT_ANSWER = "SMS_CONSENT_ANSWER_MESSAGE",
+    TERMS_CONSENT_QUESTION = "TERMS_AND_CONDITIONS_CONSENT_QUESTION_MESSAGE",
+    TERMS_CONSENT_ANSWER = "TERMS_AND_CONDITIONS_CONSENT_ANSWER_MESSAGE",
+    SUBMIT_QUESTION = "SUBMIT_QUESTION_MESSAGE",
+    SUBMIT_ANSWER = "SUBMIT_ANSWER_MESSAGE",
+    RATING_CUSTOMER_SATISFACTION_QUESTION = "RATING_CUSTOMER_SATISFACTION_QUESTION_MESSAGE",
+    RATING_CUSTOMER_SATISFACTION_ANSWER = "RATING_CUSTOMER_SATISFACTION_ANSWER_MESSAGE",
+    FEEDBACK_CUSTOMER_SATISFACTION_QUESTION = "FEEDBACK_CUSTOMER_SATISFACTION_QUESTION_MESSAGE",
+    FEEDBACK_CUSTOMER_SATISFACTION_ANSWER = "FEEDBACK_CUSTOMER_SATISFACTION_ANSWER_MESSAGE"
+}
 export type Trigger = {
     action: string;
 };
@@ -102,7 +120,20 @@ export declare enum ContentComponent {
     TEXT = "Text",
     VOICE_PLAYER = "VoicePlayer",
     VIDEO_PLAYER = "VideoPlayer",
-    SLIDER = "Slider"
+    SLIDER = "Slider",
+    /** The bubble is a placeholder for the "what to expect" card, not text. */
+    ASSESSMENT_SUMMARY = "AssessmentSummary",
+    /** The bubble is a placeholder for the resume-link control, not text. */
+    COPY_LINK = "CopyLink"
+}
+/**
+ * Whole-bubble values the backend uses to mark a content bubble as a card placeholder. The stream
+ * never sends them — it emits an event at that bubble's position instead — so these are only
+ * reached on a transcript stored before the backend began annotating `component`.
+ */
+export declare enum ContentMarker {
+    ASSESSMENT_SUMMARY = "{assessment.summary}",
+    ASSESSMENT_LINK = "{assessment.link}"
 }
 /** BE message kind: an unanswerable agent aside vs a real question. */
 export declare enum MessageKind {
@@ -146,7 +177,7 @@ export type Answer = {
 export interface Message<T> {
     id: string;
     sender: MessageSender;
-    messageIdentifier?: MessageIdentifier;
+    messageIdentifier?: MessageIdentifier | string;
     data: T;
 }
 export type CandidateResponse = Message<Answer>;

package/dist/api/types/responses.d.ts

@@ -27,11 +27,16 @@ export type StartAtsResponse = {
     /** Role/position title for the welcome + header (optional; falls back to branding.title). */
     roleTitle?: string;
     /**
-     * Pre-interview "what to expect" summary. Returned here too (not just on the
-     * stream) so it survives reload — re-hydration goes through /start, which never
-     * replays the stream. The store captures whichever source arrives first.
+     * "What to expect" counts. Returned here too (not just on the stream) so they survive reload —
+     * re-hydration goes through /start, which never replays the stream. The store captures whichever
+     * source arrives first.
      */
     summary?: AssessmentSummary;
+    /**
+     * The assessment's resume link, for the copy-link bubble on a reloaded transcript (the stream's
+     * ASSESSMENT_LINK frame is the live source). Absent until the backend ships the field.
+     */
+    assessmentLink?: string;
 };
 export type NextResponse = {
     nextResponse: AgentResponse;
@@ -65,6 +70,7 @@ export type VideoSignedUrlResponse = {
 export type AccessManagementResponse = {
     shouldAuthenticate: boolean;
     emailHint?: string;
+    /** Assessment language; the gate renders before /start/ats, so this is its only source. */
     language?: string;
 };
 /** POST verify-access — whether the candidate email matches. */
@@ -81,6 +87,7 @@ export declare enum AgUiEventType {
     RUN_STARTED = "RUN_STARTED",
     STATE_SNAPSHOT = "STATE_SNAPSHOT",
     ASSESSMENT_SUMMARY = "ASSESSMENT_SUMMARY",
+    ASSESSMENT_LINK = "ASSESSMENT_LINK",
     TEXT_MESSAGE_START = "TEXT_MESSAGE_START",
     TEXT_MESSAGE_CONTENT = "TEXT_MESSAGE_CONTENT",
     TEXT_MESSAGE_END = "TEXT_MESSAGE_END",
@@ -88,16 +95,10 @@ export declare enum AgUiEventType {
     RUN_FINISHED = "RUN_FINISHED",
     RUN_ERROR = "RUN_ERROR"
 }
-/** Lifecycle of the BE-authored Continue action on the pre-interview summary. */
-export declare enum SummaryActionStatus {
-    /** The BE stopped at the gate and is waiting for the click. */
-    PENDING = "PENDING",
-    /** The gate is already past (reload after continuing). */
-    CLICKED = "CLICKED"
-}
 /**
- * Pre-interview "what to expect" summary (AG-UI ASSESSMENT_SUMMARY, emitted once before dialogue).
- * The backend sends structured counts only; the frontend owns the category labels/descriptions.
+ * "What to expect" counts for the card the client draws inside the introduction break (AG-UI
+ * ASSESSMENT_SUMMARY). The backend sends structured counts only; the labels come from the
+ * translation file.
  */
 export type AssessmentSummary = {
     title: string;
@@ -107,15 +108,15 @@ export type AssessmentSummary = {
         type: QuestionType;
         count: number;
     }[];
-    /** BE-authored Continue action; status PENDING gates the dialogue, CLICKED is past the gate. */
-    continueAction: {
-        label: string;
-        status: SummaryActionStatus;
-    };
 };
 /** STATE_SNAPSHOT.snapshot.question — same data as our Question, but `types` is `questionTypes`. */
 export type SnapshotQuestion = {
     _id: string;
+    /**
+     * Id of the chat-log message this question belongs to — the baseId the TEXT_MESSAGE_* frames
+     * prefix their own ids with. Distinct from `_id`, which identifies the question itself.
+     */
+    messageId?: string;
     masterId?: string;
     /** Bubble template: Hint (agent context, unanswerable) vs Question. */
     kind?: MessageKind;
@@ -139,6 +140,8 @@ export type AgUiFrame = {
     };
     /** ASSESSMENT_SUMMARY payload (present only on that frame). */
     summary?: AssessmentSummary;
+    /** ASSESSMENT_LINK payload — the assessment's resume link (present only on that frame). */
+    url?: string;
     /** TEXT_MESSAGE_* message id, shape "<baseId>:<contentIndex>"; segments bundled messages. */
     messageId?: string;
     delta?: string;

package/dist/api.js

@@ -1,2 +1,2 @@
-import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _, v, x as y, y as b } from "./messages-DCvBcspv.js";
-export { s as API_ORIGIN_BY_ENV, p as AgUiEventType, g as AssessmentStatus, d as ButtonType, o as CHATBOT_API_PATH, a as ChatbotApiClient, m as ContentComponent, c as ContentType, e as DEFAULT_LOCAL_API_ORIGIN, v as ENVIRONMENTS, t as MessageKind, f as MessageSender, h as PHService, r as PiiQuestionType, l as QuestionType, b as REGIONS, _ as RuleName, u as SummaryActionStatus, i as VideoQuestionType, n as buildChatbotBaseUrl, y as resolveApiOrigin };
+import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, x as b, y as x } from "./messages-C00e82NS.js";
+export { s as API_ORIGIN_BY_ENV, c as AgUiEventType, _ as AssessmentStatus, f as ButtonType, t as CHATBOT_API_PATH, d as ChatbotApiClient, h as ContentComponent, l as ContentMarker, n as ContentType, y as DEFAULT_LOCAL_API_ORIGIN, x as ENVIRONMENTS, p as MessageIdentifier, g as MessageKind, i as MessageSender, u as PHService, v as PiiQuestionType, a as QuestionType, r as REGIONS, o as RuleName, m as VideoQuestionType, b as buildChatbotBaseUrl, e as resolveApiOrigin };

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

@@ -0,0 +1,14 @@
+import { MessageItem } from './types';
+/** A card a marker content bubble is drawn as, in place of its text. */
+export declare enum BubbleCard {
+    ASSESSMENT_SUMMARY = "ASSESSMENT_SUMMARY",
+    COPY_LINK = "COPY_LINK"
+}
+/**
+ * The card this content bubble stands for, or undefined for ordinary text. The backend's
+ * `component` is authoritative; the raw value is matched as a fallback so a transcript stored
+ * before the backend annotated components still draws the card instead of printing the marker.
+ * Matched on the whole trimmed value — a marker embedded mid-sentence stays text, which is the
+ * rule the backend applies too.
+ */
+export declare const resolveBubbleCard: (item: MessageItem) => BubbleCard | undefined;

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

@@ -1,7 +1,29 @@
-import { PiiQuestionType, VideoQuestionType, AgentResponse, CandidateResponse, Tag } from '../../api/types/messages';
-import { MessageBubble } from './types';
+import { MessageIdentifier, PiiQuestionType, VideoQuestionType, AgentResponse, CandidateResponse, Question, Tag } from '../../api/types/messages';
+import { QuestionRole, MessageBubble } from './types';
 export declare const piiQuestionTypeFromQuestionTags: (tags?: Tag[]) => PiiQuestionType | undefined;
 export declare const videoQuestionTypeFromQuestionTags: (tags?: Tag[]) => VideoQuestionType | undefined;
+/**
+ * Whether this question opts out of the paste block. An absent tag means blocked: the default is
+ * the restrictive one, so a question only becomes pasteable when the BE says so explicitly.
+ */
+export declare const questionTagsAllowPaste: (tags?: Tag[]) => boolean;
+/**
+ * Whether this question is the SMS-consent prompt. The BE marks it with a button-type tag rather
+ * than a dedicated message identifier, and the tag rides along on the answer bubble too.
+ */
+export declare const questionTagsAreSmsConsent: (tags?: Tag[]) => boolean;
+/**
+ * Classifies a question turn, mirroring the BE's checkIfNormalQuestion: an unanswerable turn is
+ * settled first, then a break, then `messageIdentifier` — the BE's own answer — and only then the raw signals
+ * the BE itself keys off (masterId, PH_BUTTON_TYPE tag, option triggers, usageWhitelist). The
+ * raw fallback exists because the streamed STATE_SNAPSHOT carries no identifier; without it a
+ * consent prompt would take an ordinal while it streams and lose it on settle.
+ *
+ * Submit and feedback are resolved before the consent gates, so a button carrying both markings
+ * can never come out as a counted question. SMS consent is resolved before terms consent because
+ * both ride the same tag name.
+ */
+export declare const resolveQuestionRole: (question?: Question, messageIdentifier?: MessageIdentifier | string) => QuestionRole;
 export declare const convertRawCandidateResponseToMessageBubble: (response: CandidateResponse) => MessageBubble;
 export declare const convertRawAgentResponseToMessageBubble: (response: AgentResponse, hasNext?: boolean) => MessageBubble;
 export declare const convertRawResponseToMessageBubble: (response: CandidateResponse | AgentResponse, hasNext?: boolean) => MessageBubble | undefined;

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

@@ -0,0 +1,10 @@
+import { MessageBubble } from './types';
+/** A turn that counts as an interview question — see QuestionRole. */
+export declare const isNormalQuestionBubble: (bubble: MessageBubble) => boolean;
+/**
+ * 1-based ordinal for each normal agent question turn, keyed by bubble id. Bubbles absent from
+ * the map take no "Question n of N" eyebrow.
+ */
+export declare const normalQuestionOrdinals: (bubbles: MessageBubble[]) => Map<string, number>;
+/** Normal questions the candidate has answered — the progress bar's value. */
+export declare const normalAnswerCount: (bubbles: MessageBubble[]) => number;

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

@@ -1,4 +1,22 @@
 import { AnswerContent, ContentComponent, ContentType, MessageKind, MessageIdentifier, MessageSender, PHService, PiiQuestionType, QuestionRule, QuestionType, Style, Tag, Trigger, VideoQuestionType } from '../../api/types/messages';
+/**
+ * What a question turn is for. Only NORMAL turns are interview questions: they are the ones the
+ * BE counts in `numOfNormalQuestion`, so they are the only ones that may take an ordinal in
+ * "Question n of N" or move the progress bar. Every other role is scaffolding around the
+ * interview (an aside, an identity field, a consent gate, the submit button, post-submit
+ * feedback). Resolved once at conversion — see `resolveQuestionRole`.
+ */
+export declare enum QuestionRole {
+    NORMAL = "NORMAL",
+    HINT = "HINT",
+    PII = "PII",
+    TERMS_CONSENT = "TERMS_CONSENT",
+    SMS_CONSENT = "SMS_CONSENT",
+    SUBMIT = "SUBMIT",
+    CUSTOMER_SATISFACTION = "CUSTOMER_SATISFACTION",
+    /** An acknowledgement step in the introduction — blocking, but never a counted question. */
+    BREAK = "BREAK"
+}
 export declare enum BubbleStatus {
     ANSWERED = "ANSWERED",
     ANSWERING = "ANSWERING",
@@ -32,7 +50,7 @@ export type MessageBubbleData = {
 export type MessageBubble = {
     status: BubbleStatus;
     sender: MessageSender;
-    messageIdentifier?: MessageIdentifier;
+    messageIdentifier?: MessageIdentifier | string;
     id: string;
     types: QuestionType[];
     usageWhitelist?: PHService[];
@@ -41,6 +59,8 @@ export type MessageBubble = {
     masterId?: string;
     /** BE-provided message kind; falls back to `types` when absent. */
     messageKind?: MessageKind;
+    /** What this turn is for; only NORMAL turns are counted questions. */
+    questionRole: QuestionRole;
     piiQuestionType?: PiiQuestionType;
     videoQuestionType?: VideoQuestionType;
     /** Video answer in flight: upload progress 0–1 (PENDING video bubbles). */

package/dist/core/constants.d.ts

@@ -1,3 +1,4 @@
+import { AssessmentStatus } from '../api/types/messages';
 /** Streaming reveal cadence: ms per char-step (React passes 0 under prefers-reduced-motion). */
 export declare const STREAM_REVEAL_MS = 12;
 /** Chars revealed per reveal tick — bounds store writes to ~60/s at the default cadence. */
@@ -6,9 +7,39 @@ export declare const STREAM_CHARS_PER_TICK = 2;
 export declare const STREAM_BUBBLE_ID_PREFIX = "stream-live";
 export declare const QUESTION_TAG_PII_TYPE = "PII_TYPE";
 export declare const QUESTION_TAG_VIDEO_TYPE = "VIDEO_TYPE";
+export declare const QUESTION_TAG_PH_BUTTON_TYPE = "PH_BUTTON_TYPE";
+/** Question tag opting a single question out of the paste block. */
+export declare const QUESTION_TAG_ALLOW_PASTE = "ALLOW_PASTE";
+/** PH_BUTTON_TYPE value marking the SMS-consent prompt and its answer. */
+export declare const QUESTION_TAG_VALUE_SMS_CONSENT = "ph_sms_consent";
+/** PH_BUTTON_TYPE value marking the terms-and-conditions consent prompt and its answer. */
+export declare const QUESTION_TAG_VALUE_TERMS_CONSENT = "ph_i_accept";
+/** masterId the BE gives the terms-and-conditions consent prompt. */
+export declare const QUESTION_MASTER_ID_TERMS_CONSENT = "ph_i_accept";
+/** masterId the BE gives the final submit button. */
+export declare const QUESTION_MASTER_ID_SUBMIT = "ph_submit_assessment";
+/** BGQ option trigger actions the BE reads as "this is the consent / submit button". */
+export declare const TRIGGER_ACTION_CONSENT = "continue_assessment_with_consent";
+export declare const TRIGGER_ACTION_SUBMIT = "submit_assessment";
+/** Trigger on a break's single button; the click only advances the dialogue. */
+export declare const TRIGGER_ACTION_BREAK = "continue_dialogue";
+/** Fixed answer value a break acknowledgement stores — nothing reads it back. */
+export declare const ANSWER_VALUE_BREAK_CONTINUE = "ph_continue_dialogue";
+/** Tag values are wire strings, not booleans; only the exact string counts as opt-in. */
+export declare const QUESTION_TAG_VALUE_TRUE = "true";
+/**
+ * Statuses the assessment reaches once the candidate has pressed the final submit. Every answer
+ * is final from that point, so the chat log drops its Edit affordances.
+ */
+export declare const SUBMITTED_ASSESSMENT_STATUSES: readonly AssessmentStatus[];
 /** Experience-rating slider range and starting position (legacy defaultSliderValue). */
 export declare const SLIDER_MIN = 1;
 export declare const SLIDER_MAX = 10;
 export declare const SLIDER_DEFAULT_VALUE = 8;
 /** Default video answer length when the question carries no max-seconds rule. */
 export declare const MAX_VIDEO_SECONDS_DEFAULT = 60;
+/**
+ * Answer text the backend reads as "the candidate skipped the optional feedback comment". Sending
+ * nothing is a valid answer there, so an empty composer submits this sentinel rather than ''.
+ */
+export declare const SKIP_FEEDBACK_COMMENT_TEXT = "SAPIA_SKIP_FEEDBACK";

package/dist/core/events.d.ts

@@ -12,8 +12,15 @@ export type ChatbotEventMap = {
     [CHATBOT_EVENTS.ASSESSMENT_STARTED]: {
         assessmentId: string;
     };
+    /**
+     * `justCompleted` is true only when the interview finished during this session — the legacy
+     * FI_ASSESSMENT_ENDED semantics (fired off a /next with no next question). It is false when the
+     * assessment was already over on load, or ended on a terminal message, where legacy stayed
+     * silent. A host acting on the end of an interview (an auto-redirect, analytics) must gate on it.
+     */
     [CHATBOT_EVENTS.ASSESSMENT_ENDED]: {
         assessmentId: string;
+        justCompleted: boolean;
     };
     [CHATBOT_EVENTS.ASSESSMENT_DUPLICATED]: {
         assessmentId: string;

package/dist/core/internalUser.d.ts

@@ -0,0 +1,13 @@
+/** Query params the widget honours on the hosting page. Mirrors legacy src/types/UrlParamKey.ts. */
+export declare enum UrlParamKey {
+    /** Legacy internal-tester flag; bypasses the paste block. */
+    INTERNAL_USER = "internalUser",
+    /** Sapia-staff flag; same bypass, kept separate so hosts can tell the two audiences apart. */
+    SAPIAN = "sapian"
+}
+/**
+ * Reads the internal-session flags off the host page URL. Either param unlocks paste, so a tester
+ * can re-enable it from the address bar without a host redeploy — the block is an integrity signal
+ * aimed at candidates, not a security boundary.
+ */
+export declare const isInternalUserFromUrl: () => boolean;

package/dist/core/interview.d.ts

@@ -1,5 +1,6 @@
 import { ChatbotApiClient } from '../api/client';
 import { PiiErrorKey } from './validation/pii';
+import { LocationAnswer } from '../api/places';
 import { ChatbotEventEmitter } from './events';
 import { InterviewStore } from './store';
 export declare const ERROR_TYPE_START_FAILED = "FI_START_ASSESSMENT_FAILED";
@@ -12,6 +13,7 @@ export declare const ERROR_TYPE_VERIFY_ACCESS_FAILED = "FI_VERIFY_ACCESS_FAILED"
 export declare const ERROR_TYPE_DETECT_AGC_FAILED = "FI_DETECT_AGC_FAILED";
 export declare const LOG_TYPE_INVALID_PHONE_NUMBER = "INVALID_PHONE_NUMBER";
 export declare const LOG_TYPE_INVALID_PASTE_ANSWER_ACTION = "INVALID_PASTE_ANSWER_ACTION";
+export declare const LOG_TYPE_INVALID_REDIRECT_URL = "INVALID_REDIRECT_URL";
 /** Outcome of a validated PII submission (drives the UI error/confirm modals). */
 export declare enum PiiSubmitStatus {
     SUBMITTED = "submitted",
@@ -48,7 +50,8 @@ export declare class InterviewEngine {
     private readonly emitter;
     private readonly assessmentId;
     private readonly userAgent;
-    private readonly language;
+    /** Reassigned when /access-management names the assessment language before the gate. */
+    private language;
     private readonly welcomeGate;
     private readonly streamRevealMs;
     /** Aborts the in-flight stream when a new load starts. */
@@ -81,8 +84,6 @@ export declare class InterviewEngine {
      * the agent's opening message(s). No-op unless we're holding at the gate.
      */
     confirmWelcome(): Promise<void>;
-    /** Candidate clicked Continue on the summary gate — re-call next/stream to stream the dialogue. */
-    continueFromSummary(): Promise<void>;
     /**
      * Ported from legacy firstLoadMessageBasedOnChatLogs: empty history → fetch the
      * first message; history ending in a HINT (either the agent's question or the
@@ -112,11 +113,12 @@ export declare class InterviewEngine {
     submitNameAnswer(text: string): Promise<PiiSubmitOutcome>;
     /** Submit the name value the candidate confirmed in the extraction modal. */
     submitNameConfirmed(text: string): Promise<void>;
-    /** Submit a location PII answer (address text + serialized place; legacy handleSelectLocation). */
-    submitLocationAnswer(location: {
-        address: string;
-        [key: string]: unknown;
-    }): Promise<void>;
+    /**
+     * 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.
+     * A null coordinate is accepted — it stores the answer without a mappable location.
+     */
+    submitLocationAnswer(location: LocationAnswer): 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
@@ -146,6 +148,12 @@ export declare class InterviewEngine {
     private editExistingAnswer;
     /** Question being answered: the one under edit if editing, else the last agent bubble. */
     private currentEditableQuestionId;
+    /**
+     * PII subtype of the question the composer targets. Must follow the edit like
+     * currentEditableQuestionId does: re-editing an earlier name answer while the interview
+     * has moved on would otherwise validate against a later, non-PII question and reject
+     * every input.
+     */
     private currentPiiType;
     /**
      * Submit the selected option (MCQ/DROPDOWN/BGQ, incl. the terms-accept MCQ) of the
@@ -163,7 +171,9 @@ export declare class InterviewEngine {
     continueAfterAgcWarning(): Promise<void>;
     /** Dismiss the AGC warning to edit the answer (legacy "Edit"). */
     dismissAgcWarning(): void;
-    /** Emits the legacy INVALID_PASTE_ANSWER_ACTION log when paste is disallowed. */
+    /** Dismiss the edit-failure dialog; the composer reopens on the edit, so send retries it. */
+    dismissEditFailure(): void;
+    /** Emits the legacy INVALID_PASTE_ANSWER_ACTION log; fires only once a paste has been refused. */
     reportPaste(): void;
     /** Submit the experience-rating slider score (legacy handleSubmitRating). */
     submitSliderAnswer(score: number): Promise<void>;
@@ -174,6 +184,13 @@ export declare class InterviewEngine {
     private currentQuestionId;
     /** The synthetic candidate bubble holding the question's selectable options. */
     private inlineCandidateBubble;
+    /**
+     * The role of the question this answer belongs to, read off its agent bubble. Locally-built
+     * answer bubbles must carry it: an optimistic bubble that settles without a server echo keeps
+     * the role assigned here, and a PII or consent answer wrongly marked NORMAL would move the
+     * progress bar.
+     */
+    private questionRoleFor;
     private appendOptimisticCandidateBubble;
     private setPendingBubbleStatus;
     /** Swap the in-flight bubble for the server-confirmed candidate response. */

package/dist/core/persistence.d.ts

@@ -2,3 +2,6 @@
 export declare const getVerifiedEmail: (assessmentId: string, now?: number) => string | undefined;
 /** Persist a verified email for the assessment with the 30-minute legacy TTL. */
 export declare const saveVerifiedEmail: (assessmentId: string, candidateEmail: string, now?: number) => void;
+/** Whether the candidate opted out of the below-minimum word-count warning for this assessment. */
+export declare const getSkipShortAnswerWarning: (assessmentId: string) => boolean;
+export declare const setSkipShortAnswerWarning: (assessmentId: string, skip: boolean) => void;

package/dist/core/redirect.d.ts

@@ -0,0 +1,2 @@
+/** Only absolute http(s) URLs are offered; anything else is host misconfiguration, not a link. */
+export declare const validRedirectUrl: (url?: string) => string | undefined;

package/dist/core/store.d.ts

@@ -12,7 +12,15 @@ export declare enum InterviewPhase {
     WELCOME = "welcome",
     ACTIVE = "active",
     ENDED = "ended",
-    FAILED = "failed"
+    FAILED = "failed",
+    /** The cohort behind this assessment is closed; the interview can never be taken. */
+    COHORT_CLOSED = "cohort-closed",
+    /**
+     * The backend ended the interview with an explanatory message (archived cohort / reused
+     * assessment) rather than a completion. Distinct from ENDED so the shell shows the message
+     * instead of the completion screen.
+     */
+    TERMINAL_MESSAGE = "terminal-message"
 }
 export type InterviewState = {
     phase: InterviewPhase;
@@ -26,15 +34,14 @@ export type InterviewState = {
     sendingAnswer: boolean;
     numOfNormalQuestion: number;
     numOfNormalAnswer: number;
-    /** Pre-interview "what to expect" summary from the stream; rendered up front once it arrives. */
+    /** "What to expect" counts, drawn by the summary bubble inside the introduction break. */
     assessmentSummary?: AssessmentSummary;
-    /** True while the fresh-start summary gate is loading (before it resolves) — renders the
-     * summary card's dots as the sole loader and suppresses the generic typing bubble. */
-    loadingSummaryGate?: boolean;
-    /** True while the BE has stopped at the pre-interview summary gate, awaiting a Continue click. */
-    awaitingSummaryContinue?: boolean;
-    /** True once the summary is settled (past the gate / reload) — renders as a static pinned header. */
-    summaryPinned?: boolean;
+    /**
+     * Resume link for the copy-link bubble. From /start on reload and from the ASSESSMENT_LINK frame
+     * while streaming; the widget can be embedded on a host page, so the current URL is only a last
+     * resort.
+     */
+    assessmentLink?: string;
     branding?: Branding;
     /** Candidate display name for the welcome/done screens (optional; from /start/ats). */
     candidateName?: string;
@@ -53,12 +60,18 @@ export type InterviewState = {
     /** AGC (automated-content) detection attempt count + whether another check is allowed. */
     agcAttempt?: number;
     allowNextAgcDetection?: boolean;
+    /** Terms accepted for this assessment; locks PII and SMS-consent answers against re-editing. */
+    termsAccepted?: boolean;
     /** Show the AGC warning modal (automated content suspected on submit). */
     showAgcWarning?: boolean;
+    /** Question whose edited answer failed to save; drives the retry dialog. */
+    editFailedQuestionId?: string;
     /** Interview language (resolved); drives translations + text direction. */
     language?: string;
     /** Fetched translation file (flat key/value); undefined → bundled fallback only. */
     translations?: Record<string, string>;
+    /** Backend copy for TERMINAL_MESSAGE (archived cohort / reused assessment), as markdown. */
+    terminalMessage?: string;
     lastError?: {
         type: string;
         message: string;

package/dist/core/validation/wordCount.d.ts

@@ -0,0 +1 @@
+export declare const countWords: (text: string) => number;

package/dist/{dist-Bwlks_W8.js → dist-waE-4cub.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-C00e82NS.js";
+import { t } from "./react-DkQKleWD.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-Bwlks_W8.js.map
+//# sourceMappingURL=dist-waE-4cub.js.map

package/dist/embed/compat.d.ts

@@ -58,7 +58,7 @@ export type PHChatBotOptions = {
     jobRequisitionShortcode?: string;
     applicationShortcode?: string;
     showHeader?: boolean;
-    /** Accepted for source compatibility; the widget does not order assessments. */
+    /** Internal session (Sapia staff / QA): permits paste on every question. */
     isInternalUser?: boolean;
     apiOrigin?: string;
 };

package/dist/embed/createChatbot.d.ts

@@ -9,8 +9,14 @@ export type CreateChatbotOptions = {
     apiOrigin?: string;
     theme?: Theme;
     showHeader?: boolean;
+    /** Internal session (Sapia staff / QA): permits paste on every question. */
+    isInternalUser?: boolean;
     /** Interview language override (e.g. "fr"); defaults to the browser language. */
     language?: string;
+    /** Absolute http(s) URL offered as a "continue" CTA once the interview ends. */
+    redirectUrl?: string;
+    /** Host's own Google Places key for the location question; defaults to the bundled key. */
+    placesApiKey?: string;
     /** Custom fetch (e.g. a mocked SSE stream for demos/tests). */
     fetchImpl?: typeof fetch;
 };

package/dist/{fix-webm-duration-QAy9T6AR.js → fix-webm-duration-IniZA6tF.js}

@@ -1,4 +1,4 @@
-import { S as e } from "./messages-DCvBcspv.js";
+import { C as e } from "./messages-C00e82NS.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-QAy9T6AR.js.map
+//# sourceMappingURL=fix-webm-duration-IniZA6tF.js.map