@sapia-ai/chatbot-v3 1.2.0 → 1.3.1-beta.1.g9504c7e

package/dist/{EmbeddedVideoPlayer-C_8tKis8.js → EmbeddedVideoPlayer-DTzRqNcQ.js}

@@ -1,6 +1,6 @@
-import { T as e } from "./messages-t5h3u6nr.js";
-import { t } from "./react-BtFG4mMU.js";
-import { t as n } from "./jsx-runtime-CpK9sRtl.js";
+import { T as e } from "./messages-C00e82NS.js";
+import { t } from "./react-DkQKleWD.js";
+import { t as n } from "./jsx-runtime-DN_m6Qdv.js";
 import { t as r } from "./defineProperty-DiFpLzd2.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/patterns.js
 var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3a|wav|weba|aac|oga|spx)($|\?)/i, o = /\.(mp4|og[gv]|webm|mov|m4v)(#t=[,\d+]+)?($|\?)/i, s = /\.(m3u8)($|\?)/i, c = /\.(mpd)($|\?)/i, l = /stream\.mux\.com\/(?!\w+\.m3u8)(\w+)/, u = /(?:youtu\.be\/|youtube(?:-nocookie|education)?\.com\/(?:embed\/|v\/|watch\/|watch\?v=|watch\?.+&v=|shorts\/|live\/))((\w|-){11})|youtube\.com\/playlist\?list=|youtube\.com\/user\//, d = /vimeo\.com\/(?!progressive_redirect).+/, f = /(?:wistia\.(?:com|net)|wi\.st)\/(?:medias|embed)\/(?:iframe\/)?([^?]+)/, p = /open\.spotify\.com\/(\w+)\/(\w+)/i, m = /(?:www\.|go\.)?twitch\.tv\/([a-zA-Z0-9_]+|(videos?\/|\?video=)\d+)($|\?)/, h = /tiktok\.com\/(?:player\/v1\/|share\/video\/|@[^/]+\/video\/)([0-9]+)/, g = (e, t) => {
@@ -34,7 +34,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !0,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerHls' */
-			"./react-Bx1VLQqP.js"
+			"./react-A0_ZwPyM.js"
 ))
 	},
 	{
@@ -44,7 +44,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !0,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerDash' */
-			"./react-yXcg2glq.js"
+			"./react-ByP48xLV.js"
 ))
 	},
 	{
@@ -54,7 +54,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !0,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerMux' */
-			"./dist-7zan-9V3.js"
+			"./dist-waE-4cub.js"
 ))
 	},
 	{
@@ -63,7 +63,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canPlay: _.youtube,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerYouTube' */
-			"./react--hlAJW6n.js"
+			"./react-BDGt_WsZ.js"
 ))
 	},
 	{
@@ -72,7 +72,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canPlay: _.vimeo,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerVimeo' */
-			"./react-DFkljL-6.js"
+			"./react-C9oBRlX8.js"
 ))
 	},
 	{
@@ -82,7 +82,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !0,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerWistia' */
-			"./react-BKQw6USG.js"
+			"./react-B_YNH2g9.js"
 ))
 	},
 	{
@@ -92,7 +92,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !1,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerSpotify' */
-			"./react-DJK2_GuR.js"
+			"./react-euSb4sIX.js"
 ))
 	},
 	{
@@ -102,7 +102,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !1,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerTwitch' */
-			"./react-B6p_EGvt.js"
+			"./react-d-THpGrV.js"
 ))
 	},
 	{
@@ -112,7 +112,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 		canEnablePIP: () => !1,
 		player: (0, i.lazy)(() => import(
 			/* webpackChunkName: 'reactPlayerTiktok' */
-			"./react-Bh9U4IBe.js"
+			"./react-D5yWOfXN.js"
 ))
 	},
 	{
@@ -181,7 +181,7 @@ var i = /* @__PURE__ */ e(t(), 1), a = /\.(m4a|m4b|mp4a|mpga|mp2|mp2a|mp3|m2a|m3
 x.displayName = "Player";
 var ee = x, S = (0, i.lazy)(() => import(
 	/* webpackChunkName: 'reactPlayerPreview' */
-	"./Preview-CbNUoib5.js"
+	"./Preview-Dd7KyhMk.js"
 )), C = [], w = (e, t) => {
 	let n = (n) => {
 		for (let t of [...C, ...e]) if (n && t.canPlay(n)) return t;
@@ -1265,4 +1265,4 @@ var $ = n(), xe = (e) => {
 //#endregion
 export { Te as EmbeddedVideoPlayer };
 
-//# sourceMappingURL=EmbeddedVideoPlayer-C_8tKis8.js.map
+//# sourceMappingURL=EmbeddedVideoPlayer-DTzRqNcQ.js.map

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

@@ -1,5 +1,5 @@
-import { T as e } from "./messages-t5h3u6nr.js";
-import { t } from "./react-BtFG4mMU.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-CbNUoib5.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",
@@ -71,8 +73,16 @@ export declare enum AssessmentStatus {
  * 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",
-    FEEDBACK_CUSTOMER_SATISFACTION_QUESTION = "FEEDBACK_CUSTOMER_SATISFACTION_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;
@@ -110,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 {

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;
@@ -82,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",
@@ -89,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;
@@ -108,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;
@@ -140,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 { 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-t5h3u6nr.js";
-export { s as API_ORIGIN_BY_ENV, d as AgUiEventType, _ as AssessmentStatus, f as ButtonType, t as CHATBOT_API_PATH, m as ChatbotApiClient, h as ContentComponent, l as ContentType, y as DEFAULT_LOCAL_API_ORIGIN, x as ENVIRONMENTS, n as MessageIdentifier, p as MessageKind, g as MessageSender, i as PHService, u as PiiQuestionType, v as QuestionType, r as REGIONS, a as RuleName, c as SummaryActionStatus, o as VideoQuestionType, b as buildChatbotBaseUrl, e 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,5 +1,5 @@
-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;
 /**
@@ -12,6 +12,18 @@ export declare const questionTagsAllowPaste: (tags?: Tag[]) => boolean;
  * 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",
@@ -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

@@ -12,6 +12,25 @@ export declare const QUESTION_TAG_PH_BUTTON_TYPE = "PH_BUTTON_TYPE";
 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";
+/**
+ * Bubble id the BE gives the "you already started this assessment" notice. Its link must carry the
+ * candidate off to the assessment already in progress, so it is the one agent link that stays in
+ * the current tab — a new tab would leave them sitting in this dead duplicate.
+ */
+export declare const DUPLICATED_ASSESSMENT_LINK_BUBBLE_ID = "410270a8-73c9-51b8-b6ae-a6effc5e6cda";
+/** 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";
 /**

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";
@@ -64,6 +65,8 @@ export declare class InterviewEngine {
     private lastVideoAnswer?;
     /** Option id held back pending the AGC warning resolution. */
     private pendingAgcOptionId?;
+    /** Once-per-session latch for the AI-use guidance; the persisted flag covers reloads. */
+    private agcGuidanceTriggered;
     constructor(deps: InterviewEngineDeps);
     /** Fetch the translation file; on failure the bundled fallback is used. */
     private loadTranslations;
@@ -83,8 +86,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
@@ -114,11 +115,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
@@ -148,6 +150,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
@@ -165,6 +173,14 @@ export declare class InterviewEngine {
     continueAfterAgcWarning(): Promise<void>;
     /** Dismiss the AGC warning to edit the answer (legacy "Edit"). */
     dismissAgcWarning(): void;
+    /**
+     * Proactive AI-use guidance, shown once per assessment when the candidate reaches their
+     * first free-text interview question. Re-editing an earlier answer never triggers it —
+     * the candidate has already been told (legacy useAgcGuidance).
+     */
+    private maybeShowAgcGuidance;
+    /** Candidate acknowledged the guidance; persist before a reload can lose it. */
+    acknowledgeAgcGuidance(): void;
     /** 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. */
@@ -178,6 +194,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

@@ -5,3 +5,6 @@ export declare const saveVerifiedEmail: (assessmentId: string, candidateEmail: s
 /** 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;
+/** Whether this assessment's proactive AI-use guidance has already been acknowledged. */
+export declare const getAgcGuidanceShown: (assessmentId: string) => boolean;
+export declare const setAgcGuidanceShown: (assessmentId: string) => void;

package/dist/core/store.d.ts

@@ -34,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;
@@ -63,8 +62,16 @@ export type InterviewState = {
     allowNextAgcDetection?: boolean;
     /** Terms accepted for this assessment; locks PII and SMS-consent answers against re-editing. */
     termsAccepted?: boolean;
+    /**
+     * The BE reported this assessment a duplicate of one already in progress. Latched: the status
+     * can be set on the response carrying the notice and gone from the empty one that follows. Holds
+     * back the completion screen and freezes every answer — nothing written here can be assessed.
+     */
+    duplicated?: boolean;
     /** Show the AGC warning modal (automated content suspected on submit). */
     showAgcWarning?: boolean;
+    /** Show the one-time proactive AI-use guidance modal, before the first free-text answer. */
+    showAgcGuidance?: boolean;
     /** Question whose edited answer failed to save; drives the retry dialog. */
     editFailedQuestionId?: string;
     /** Interview language (resolved); drives translations + text direction. */

package/dist/{dist-7zan-9V3.js → dist-waE-4cub.js}

@@ -1,5 +1,5 @@
-import { T as e } from "./messages-t5h3u6nr.js";
-import { t } from "./react-BtFG4mMU.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-7zan-9V3.js.map
+//# sourceMappingURL=dist-waE-4cub.js.map

package/dist/embed/createChatbot.d.ts

@@ -15,6 +15,8 @@ export type CreateChatbotOptions = {
     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-CJ-IsmuV.js → fix-webm-duration-IniZA6tF.js}

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