@sapia-ai/chatbot-v3 1.3.1-beta.9.g966ae1e → 1.4.0

package/dist/{EmbeddedVideoPlayer-D_wOzAAv.js → EmbeddedVideoPlayer-G554aRrZ.js}

@@ -1,6 +1,6 @@
-import { E as e } from "./messages-DhmdgtVq.js";
-import { t } from "./react-n_76t7t4.js";
-import { t as n } from "./jsx-runtime-n3Sufh_D.js";
+import { z as e } from "./client-DG-5x86F.js";
+import { t } from "./react-DHdgNnK2.js";
+import { t as n } from "./jsx-runtime-B5vw3nIj.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-Cxd6prOd.js"
+			"./react-T5LsuM9r.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-_3Fe4HUu.js"
+			"./react-_TUsDaHa.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-BcVYIqYW.js"
+			"./dist-DsGdVwdi.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-xf6AdbdB.js"
+			"./react-B46N_vb_.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-BjMTT8OK.js"
+			"./react-SKFkpgRr.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-7TPcBgC1.js"
+			"./react-Dd6J2Pyv.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-B0vf2MBf.js"
+			"./react-CN-F_7qV.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-DVuMKYmt.js"
+			"./react-CpnhkRge.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-BQay9cEy.js"
+			"./react-abEVBgXB.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, te = (0, i.lazy)(() => import(
 	/* webpackChunkName: 'reactPlayerPreview' */
-	"./Preview-BJXCAMet.js"
+	"./Preview-CSE0hI6e.js"
 )), S = [], ne = (e, t) => {
 	let n = (n) => {
 		for (let t of [...S, ...e]) if (n && t.canPlay(n)) return t;
@@ -1297,4 +1297,4 @@ var $ = n(), xe = (e) => {
 //#endregion
 export { Me as EmbeddedVideoPlayer };
 
-//# sourceMappingURL=EmbeddedVideoPlayer-D_wOzAAv.js.map
+//# sourceMappingURL=EmbeddedVideoPlayer-G554aRrZ.js.map

package/dist/{Preview-BJXCAMet.js → Preview-CSE0hI6e.js}

@@ -1,5 +1,5 @@
-import { E as e } from "./messages-DhmdgtVq.js";
-import { t } from "./react-n_76t7t4.js";
+import { z as e } from "./client-DG-5x86F.js";
+import { t } from "./react-DHdgNnK2.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-BJXCAMet.js.map
+//# sourceMappingURL=Preview-CSE0hI6e.js.map

package/dist/api/client.d.ts

@@ -1,7 +1,9 @@
 import { default as axios, AxiosInstance } from 'axios';
 import { ChatbotClientConfig } from './config';
+import { UnauthorizedError } from './errors';
+import { HeldFiToken } from './fiToken';
 import { CandidateResponseInput, EditCandidateResponseInput, Question } from './types/messages';
-import { AccessManagementResponse, AssessmentSummary, DetectAgcResponse, EditAnswerResponse, ExtractHumanNameResponse, ExtractHumanNameType, FiToken, NextResponse, StartAtsResponse, TranslationResponse, VerifyAccessResponse, VideoSignedUrlResponse } from './types/responses';
+import { AccessManagementResponse, AssessmentSummary, CustomerSatisfactionFormField, DetectAgcResponse, EditAnswerResponse, ExtractHumanNameResponse, ExtractHumanNameType, NextResponse, PiiFormField, StartAtsResponse, TranslationResponse, VerifyAccessResponse, VideoSignedUrlResponse } from './types/responses';
 export type ChatbotApiClientOptions = ChatbotClientConfig & {
     /** Injectable for tests / instrumented hosts. */
     httpClient?: AxiosInstance;
@@ -28,6 +30,10 @@ export type NextStreamHandlers = {
     onSummary?: (summary: AssessmentSummary) => void;
     /** The assessment's resume link, emitted at the position of the copy-link bubble. */
     onLink?: (url: string) => void;
+    /** Every field of a PII run, emitted in place of the run's prompts. */
+    onPiiForm?: (fields: PiiFormField[]) => void;
+    /** The rating and comment asked after the interview, emitted in place of their prompts. */
+    onCustomerSatisfactionForm?: (fields: CustomerSatisfactionFormField[]) => void;
     /** Aborts the in-flight stream (new request / unmount). */
     signal?: AbortSignal;
 };
@@ -39,10 +45,29 @@ export declare class ChatbotApiClient {
     /** API/client headers reused by both the Axios instance and the fetch streaming path. */
     private readonly baseHeaders;
     private fiToken?;
+    private onUnauthorized?;
+    private onLapsedFiToken?;
     constructor(options: ChatbotApiClientOptions);
-    /** Dynamic session-token header for calls after /start/ats (token name varies per session). */
+    /** Dynamic session-token header (the token's name varies per region and stage). */
     private fiTokenHeaders;
-    getFiToken(): FiToken | undefined;
+    /**
+     * Runs before every guarded call. An expired token is either refused here, without spending a
+     * request, or dropped so the call goes out bare — which one is the engine's decision, because
+     * only access-management knows whether the backend would forgive this candidate.
+     */
+    private guardLapsedFiToken;
+    /** A token is held that core-fi would no longer honour — not the same as holding none. */
+    hasLapsedFiToken(): boolean;
+    getFiToken(): HeldFiToken | undefined;
+    /** Seeds a token cached from an earlier load, or drops the one held once it is rejected. */
+    setFiToken(fiToken: HeldFiToken | undefined): void;
+    /**
+     * Notified once per rejected call, from either transport. Registered rather than passed in
+     * options because the engine that handles the expiry is built after the client.
+     */
+    setOnUnauthorized(handler: (error: UnauthorizedError) => void): void;
+    /** Asked whether an expired token must refuse the call (true) or be dropped (false). */
+    setOnLapsedFiToken(handler: () => Promise<boolean>): void;
     startAts(assessmentId: string): Promise<StartAtsResponse>;
     /**
      * Loads the next question over /next/stream and consumes the
@@ -50,8 +75,12 @@ export declare class ChatbotApiClient {
      * Each frame is data-only (`data: <json>`); the discriminator is the JSON
      * `type`. Fires onMeta from STATE_SNAPSHOT and onDelta per TEXT_MESSAGE_CONTENT,
      * then resolves with the authoritative NextResponse carried by RUN_FINISHED.
+     *
+     * A whole PII form is posted as an array, which the backend reads as `candidateResponses`;
+     * the array is what marks the turn as a form submission, so the two body keys are never sent
+     * together.
      */
-    nextStream(assessmentId: string, candidateResponse: CandidateResponseInput | undefined, handlers: NextStreamHandlers): Promise<NextResponse | undefined>;
+    nextStream(assessmentId: string, input: CandidateResponseInput | CandidateResponseInput[] | undefined, handlers: NextStreamHandlers): Promise<NextResponse | undefined>;
     editAnswer(assessmentId: string, editCandidateResponse: EditCandidateResponseInput): Promise<EditAnswerResponse>;
     extractHumanName(assessmentId: string, input: {
         userText: string;

package/dist/api/config.d.ts

@@ -13,6 +13,6 @@ export type ChatbotClientConfig = {
     /** Overrides the env-derived origin (required for env "local" if not on the default port). */
     apiOrigin?: string;
 };
-export declare const resolveApiOrigin: ({ env, apiOrigin }: Pick<ChatbotClientConfig, "env" | "apiOrigin">) => string;
+export declare const resolveApiOrigin: ({ env, apiOrigin, }: Pick<ChatbotClientConfig, "env" | "apiOrigin">) => string;
 /** e.g. https://fi-api.dev.predictivehire.com/api/us-east-1/chatbot */
 export declare const buildChatbotBaseUrl: (config: ChatbotClientConfig) => string;

package/dist/api/errors.d.ts

@@ -0,0 +1,25 @@
+/** Statuses the widget branches on; a malformed body gets its own and stays a plain failure. */
+declare enum HttpStatus {
+    UNAUTHORIZED = 401,
+    NOT_FOUND = 404
+}
+/**
+ * The session token was missing, expired, or minted for another assessment. Distinct from a
+ * transport failure: the candidate recovers by verifying their email again, not by retrying.
+ */
+export declare class UnauthorizedError extends Error {
+    /** `endpoint` names the call core-fi refused, so a host report says where it happened. */
+    constructor(endpoint?: string);
+}
+/**
+ * The held token had expired and this candidate must authenticate, so the call was refused before
+ * it was sent. An UnauthorizedError so every caller handles it exactly as a 401.
+ */
+export declare class SessionLapsedError extends UnauthorizedError {
+    constructor();
+}
+/** True for a 401 from either transport — Axios on the REST calls, fetch on the stream. */
+export declare const isUnauthorized: (error: unknown) => boolean;
+/** True when the backend has no assessment with this id — a dead link, not a transient failure. */
+export declare const isNotFound: (error: unknown) => boolean;
+export { HttpStatus };

package/dist/api/fiToken.d.ts

@@ -0,0 +1,23 @@
+import { FiToken } from './types/responses';
+/**
+ * What the client and the cache hold. `expiresAt` is derived here and never travels in either
+ * direction, so `FiToken` keeps describing the wire.
+ */
+export type HeldFiToken = FiToken & {
+    expiresAt?: number;
+};
+/**
+ * Stamps a freshly received token with a local expiry. Candidate devices run with wrong clocks
+ * often enough that comparing `exp` to `Date.now()` would expire live tokens and keep dead ones;
+ * `exp - iat` is a duration measured on core-fi's clock, so counting it forward from arrival reads
+ * the local clock for elapsed time only.
+ *
+ * Must be called as the response arrives — the lifetime is anchored to that moment. A clock that
+ * jumps later (NTP correction) shifts `expiresAt` and can cost one re-verification.
+ */
+export declare const holdFiToken: (fiToken: FiToken) => HeldFiToken;
+/**
+ * A token with no readable lifetime counts as live: an unparseable payload, or an entry cached
+ * before `expiresAt` existed, must not lock out a candidate the backend would still accept.
+ */
+export declare const isFiTokenLive: (fiToken: HeldFiToken) => boolean;

package/dist/api/index.d.ts

@@ -1,4 +1,5 @@
 export { ChatbotApiClient, type ChatbotApiClientOptions } from './client';
+export { SessionLapsedError, UnauthorizedError, isNotFound, isUnauthorized } from './errors';
 export { ENVIRONMENTS, REGIONS, CHATBOT_API_PATH, API_ORIGIN_BY_ENV, DEFAULT_LOCAL_API_ORIGIN, buildChatbotBaseUrl, resolveApiOrigin, type Env, type Region, type ChatbotClientConfig, } from './config';
 export * from './types/messages';
 export * from './types/branding';

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

@@ -9,7 +9,9 @@ export type ThemeProperty = {
     value: ThemeElement;
 };
 export type Branding = {
-    customerId: string;
+    /** Dropped by the BE's chatbot-scoped branding view; older BEs still send it. */
+    customerId?: string;
+    customerName?: string;
     title?: string;
     theme?: ThemeProperty[];
     logoUrl?: string;

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

@@ -4,7 +4,11 @@ export declare enum RuleName {
     RECOMMENDED_TEXT_LENGTH = "recommendedTextLength",
     MAX_VOICE_SECONDS = "maxVoiceSeconds",
     MIN_VOICE_SECONDS = "minVoiceSeconds",
-    RECOMMENDED_VOICE_SECONDS = "recommendedVoiceSeconds"
+    RECOMMENDED_VOICE_SECONDS = "recommendedVoiceSeconds",
+    /** Fewest options a multi-select question accepts. One is the floor whether or not it is set. */
+    MIN_SELECTIONS = "minSelections",
+    /** Most options a multi-select question accepts. Absent means any number. */
+    MAX_SELECTIONS = "maxSelections"
 }
 export declare enum MessageSender {
     AGENT = "AGENT",
@@ -14,6 +18,13 @@ export declare enum QuestionType {
     HINT = "HINT",
     FTQ = "FTQ",
     MCQ = "MCQ",
+    /**
+     * The same option list as an MCQ, answered with a set rather than one choice. A type of its own
+     * because MCQ also carries the submit button, the consent gates and the personality items, none
+     * of which may ever take more than one answer. Every additional question is now this type — a
+     * single-pick one is an MSQ capped at one.
+     */
+    MSQ = "MSQ",
     VOICE = "VOICE",
     VIDEO = "VIDEO",
     SLIDER = "SLIDER",
@@ -99,10 +110,22 @@ export type ButtonGroupContent = Content & {
     triggers: Trigger[];
     style: Style;
 };
+/** One option a candidate confirmed on a multi-select question, echoed back verbatim. */
+export type AnswerSelection = {
+    id: string;
+    value: string;
+    text: string;
+};
 export type AnswerContent = {
     /** Free-text answers written in the rich composer carry markdown here — see `ui/markdown.ts`. */
     text: string;
     value: string;
+    /**
+     * Options confirmed on a multi-select question, in the order the option list defines them. The
+     * source of truth for the answer: the backend derives `text` and `value` from it by joining with
+     * `MULTI_SELECT_ANSWER_SEPARATOR`, and refuses a selection the question never offered.
+     */
+    selections?: AnswerSelection[];
     triggers?: Trigger[];
     style?: Style;
 };
@@ -124,7 +147,35 @@ export declare enum ContentComponent {
     /** 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"
+    COPY_LINK = "CopyLink",
+    /**
+     * The bubble is a placeholder for the AI-use guidance block. The backend marks the position
+     * only — the copy, the tick box and the tip are the client's, which is why the event that
+     * replaces this bubble on the stream carries no payload.
+     */
+    AGC_GUIDANCE = "AgcGuidance",
+    /**
+     * The bubble is a placeholder for the whole PII form, not for this prompt's text. Synthesised by
+     * the widget: the backend describes the run in a PII_FORM event and annotates no bubble for it.
+     */
+    PII_FORM = "PiiForm",
+    /**
+     * The bubble is the one line the interviewer says before the form. The run's own prompts are
+     * questions, not labels, so none of them can stand in for it.
+     */
+    PII_FORM_INTRO = "PiiFormIntro",
+    /** The bubble is a placeholder for the answered details, standing in for the whole run. */
+    PII_DETAILS = "PiiDetails",
+    /**
+     * The bubble is a placeholder for the feedback card (rating plus comment). Synthesised by the
+     * widget: the backend describes the run in a CUSTOMER_SATISFACTION_FORM event.
+     */
+    CUSTOMER_SATISFACTION_FORM = "CustomerSatisfactionForm",
+    /**
+     * The interviewer's one line above the feedback card. The run may open on either prompt, so
+     * neither prompt's own text can stand in for it.
+     */
+    CUSTOMER_SATISFACTION_INTRO = "CustomerSatisfactionIntro"
 }
 /**
  * Whole-bubble values the backend uses to mark a content bubble as a card placeholder. The stream
@@ -133,7 +184,8 @@ export declare enum ContentComponent {
  */
 export declare enum ContentMarker {
     ASSESSMENT_SUMMARY = "{assessment.summary}",
-    ASSESSMENT_LINK = "{assessment.link}"
+    ASSESSMENT_LINK = "{assessment.link}",
+    AGC_GUIDANCE = "{assessment.agcGuidance}"
 }
 /** BE message kind: an unanswerable agent aside vs a real question. */
 export declare enum MessageKind {
@@ -173,6 +225,8 @@ export type Answer = {
     question: Question;
     text: string;
     value: string;
+    /** Present on a multi-select answer; `text` holds the same options joined for scalar readers. */
+    selections?: AnswerSelection[];
 };
 export interface Message<T> {
     id: string;

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

@@ -1,13 +1,13 @@
 import { Branding } from './branding';
-import { AgentResponse, AssessmentStatus, BGQButton, CandidateResponse, ContentComponent, ContentType, MCQQuestionOption, MessageKind, PHService, QuestionRule, QuestionType, Tag } from './messages';
-/** Session token returned by /start/ats; sent as a dynamic header on subsequent calls. */
+import { AgentResponse, AssessmentStatus, BGQButton, CandidateResponse, ContentComponent, ContentType, MCQQuestionOption, Message, MessageKind, PHService, PiiQuestionType, QuestionRule, QuestionType, Tag } from './messages';
+/** Candidate session token, minted by /verify-access and re-minted by /start/ats and /next. */
 export type FiToken = {
     name: string;
     value: string;
 };
 export type StartAtsResponse = {
     assessmentId: string;
-    chatLogs: (CandidateResponse | AgentResponse)[];
+    chatLogs: ChatLog[];
     branding?: Branding;
     hasVideoQuestion?: boolean;
     assessmentStatus: AssessmentStatus;
@@ -24,8 +24,14 @@ export type StartAtsResponse = {
     assessmentIsReusedMessage?: AgentResponse;
     /** Candidate display name for the pre-interview welcome (optional; absent → generic greeting). */
     candidateName?: string;
-    /** Role/position title for the welcome + header (optional; falls back to branding.title). */
-    roleTitle?: string;
+    /**
+     * The cohort title, shown as the role in the header and welcome. Read this rather than
+     * `branding.title`, which the BE has already interpolated into customer-authored copy.
+     * Optional until every environment runs a BE that sends it.
+     */
+    jobTitle?: string;
+    /** Company name for the header, welcome and done screens. Optional for the same reason. */
+    customerName?: string;
     /**
      * "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
@@ -76,6 +82,11 @@ export type AccessManagementResponse = {
 /** POST verify-access — whether the candidate email matches. */
 export type VerifyAccessResponse = {
     allowToAccess: boolean;
+    /**
+     * Minted only on a match. For an assessment that already holds a candidate email this is the
+     * only place a token comes from, so /start/ats is unreachable without passing the email check.
+     */
+    fiToken?: FiToken;
 };
 /** POST detect-agc — automated-content detection on submit. */
 export type DetectAgcResponse = {
@@ -88,6 +99,9 @@ export declare enum AgUiEventType {
     STATE_SNAPSHOT = "STATE_SNAPSHOT",
     ASSESSMENT_SUMMARY = "ASSESSMENT_SUMMARY",
     ASSESSMENT_LINK = "ASSESSMENT_LINK",
+    AGC_GUIDANCE = "AGC_GUIDANCE",
+    PII_FORM = "PII_FORM",
+    CUSTOMER_SATISFACTION_FORM = "CUSTOMER_SATISFACTION_FORM",
     TEXT_MESSAGE_START = "TEXT_MESSAGE_START",
     TEXT_MESSAGE_CONTENT = "TEXT_MESSAGE_CONTENT",
     TEXT_MESSAGE_END = "TEXT_MESSAGE_END",
@@ -123,6 +137,135 @@ export type AssessmentSummary = {
         count: number;
     }[];
 };
+/** Whether a form field collects a personal detail or the SMS-updates consent that sits among them. */
+export declare enum PiiFormFieldKind {
+    PII = "PII",
+    SMS_CONSENT = "SMS_CONSENT"
+}
+/**
+ * The backend's own spelling of a PII subtype, which is NOT the `PII_TYPE` tag value the rest of
+ * the widget keys off (`PiiQuestionType`): the two vocabularies are `FULL_NAME` and `fullName`.
+ * Confined to this layer — `toPiiFormField` adapts it before a field reaches the engine.
+ */
+export declare enum PiiFormWireType {
+    FULL_NAME = "FULL_NAME",
+    FIRST_NAME = "FIRST_NAME",
+    LAST_NAME = "LAST_NAME",
+    EMAIL = "EMAIL",
+    PHONE_NUMBER = "PHONE_NUMBER",
+    LOCATION = "LOCATION"
+}
+/** A PII_FORM field exactly as it arrives, before its `piiType` is adapted. */
+export type PiiFormFieldWire = Omit<PiiFormField, 'piiType'> & {
+    /** Absent or unrecognised means "not a personal detail" — the SMS consent field carries none. */
+    piiType?: PiiFormWireType | string | null;
+};
+/**
+ * One prompt of a PII run, described so the client can draw it as a form field (AG-UI PII_FORM).
+ * The backend sends the fields in dialogue order; `questionId` is what an answer posts against.
+ * `prompt` is the authored wording — the widget names its own fields, so it is only shown where
+ * the dialogue owns the copy, as the consent question does.
+ */
+export type PiiFormField = {
+    questionId: string;
+    masterId?: string;
+    kind: PiiFormFieldKind;
+    /** Null for the SMS consent field, which is not a personal detail. */
+    piiType: PiiQuestionType | null;
+    /** Answer-input component (ignored — the field is drawn from `piiType` and `questionTypes`). */
+    component?: string | null;
+    questionTypes: QuestionType[];
+    prompt: string;
+    options?: MCQQuestionOption[] | BGQButton[];
+    rules?: QuestionRule[];
+    /** Set only on a reloaded run's responses: what the candidate gave, ready to display. */
+    answer?: string;
+    /**
+     * That answer's underlying value. Carried because consent is a state rather than text, and
+     * reading it back off the button's label would break the moment the label is reworded.
+     */
+    value?: string;
+};
+/**
+ * A PII run as a reloaded transcript carries it: one agent message describing the whole form, and
+ * — once submitted — one candidate message carrying the details it collected. The backend folds
+ * the run's stored prompt/answer pairs into these while building the response and never stores
+ * them, so a reload reads the way the interview looked. `_id` is the run's opening question id,
+ * shared by both halves so they can be paired without relying on their order.
+ *
+ * The fields arrive in the backend's own `piiType` spelling, as the stream's do; the client adapts
+ * them before the engine sees either.
+ */
+export type PiiFormMessage = Message<{
+    _id: string;
+    fields: PiiFormField[];
+}>;
+/** @see PiiFormMessage — the candidate half, whose fields carry `answer` and `value`. */
+export type PiiResponsesMessage = Message<{
+    _id: string;
+    responses: PiiFormField[];
+}>;
+/**
+ * Which family a folded form belongs to. Only the feedback payload carries it: the PII payload
+ * shipped first with the same shape and no marker, so an absent formType means PII.
+ */
+export declare enum FormType {
+    PII = "PII",
+    CUSTOMER_SATISFACTION = "CUSTOMER_SATISFACTION"
+}
+/** Whether a feedback field collects the rating or the free-text comment. */
+export declare enum CustomerSatisfactionFieldType {
+    RATING = "RATING",
+    COMMENT = "COMMENT"
+}
+/**
+ * One prompt of the feedback run (AG-UI CUSTOMER_SATISFACTION_FORM). The backend sends the fields in
+ * dialogue order, which is the order answers must be posted in — the rating is not always first.
+ */
+export type CustomerSatisfactionFormField = {
+    questionId: string;
+    masterId?: string;
+    fieldType: CustomerSatisfactionFieldType;
+    component?: string | null;
+    questionTypes: QuestionType[];
+    /** The authored wording. The card names its own fields, so this is not drawn. */
+    prompt: string;
+    rules?: QuestionRule[];
+    /** Set only on a reloaded run's responses: what the candidate gave, ready to display. */
+    answer?: string;
+    /** That answer's underlying value — the rating as a number string. */
+    value?: string;
+};
+type CustomerSatisfactionPayload = {
+    _id: string;
+    formType: FormType.CUSTOMER_SATISFACTION;
+};
+/**
+ * A feedback run as a reloaded transcript carries it, folded by the backend exactly as a PII run
+ * is: the form, and — once posted — the responses, which leave out any field the candidate skipped.
+ */
+export type CustomerSatisfactionFormMessage = Message<CustomerSatisfactionPayload & {
+    fields: CustomerSatisfactionFormField[];
+}>;
+/** @see CustomerSatisfactionFormMessage */
+export type CustomerSatisfactionResponsesMessage = Message<CustomerSatisfactionPayload & {
+    responses: CustomerSatisfactionFormField[];
+}>;
+/** Anything /start can put in `chatLogs`: a stored turn, or a form run folded into two messages. */
+export type ChatLog = CandidateResponse | AgentResponse | PiiFormMessage | PiiResponsesMessage | CustomerSatisfactionFormMessage | CustomerSatisfactionResponsesMessage;
+/**
+ * The folded halves of a PII run are told apart by their payload key alone: neither carries the
+ * `question` an answer has or the `types`/`contents` a prompt has, so a reader that goes by those
+ * would take them for an empty question and draw nothing. A feedback run folds into the same keys,
+ * so its marker is what turns it away here.
+ */
+export declare const isPiiFormMessage: (chatLog: ChatLog) => chatLog is PiiFormMessage;
+/** @see isPiiFormMessage */
+export declare const isPiiResponsesMessage: (chatLog: ChatLog) => chatLog is PiiResponsesMessage;
+/** @see CustomerSatisfactionFormMessage */
+export declare const isCustomerSatisfactionFormMessage: (chatLog: ChatLog) => chatLog is CustomerSatisfactionFormMessage;
+/** @see CustomerSatisfactionFormMessage */
+export declare const isCustomerSatisfactionResponsesMessage: (chatLog: ChatLog) => chatLog is CustomerSatisfactionResponsesMessage;
 /** STATE_SNAPSHOT.snapshot.question — same data as our Question, but `types` is `questionTypes`. */
 export type SnapshotQuestion = {
     _id: string;
@@ -156,9 +299,15 @@ export type AgUiFrame = {
     summary?: AssessmentSummary;
     /** ASSESSMENT_LINK payload — the assessment's resume link (present only on that frame). */
     url?: string;
+    /**
+     * PII_FORM / CUSTOMER_SATISFACTION_FORM payload — every field of the run, in dialogue order, in
+     * the backend's spelling. Which of the two it is follows from `type`.
+     */
+    fields?: PiiFormFieldWire[] | CustomerSatisfactionFormField[];
     /** TEXT_MESSAGE_* message id, shape "<baseId>:<contentIndex>"; segments bundled messages. */
     messageId?: string;
     delta?: string;
     result?: NextResponse;
     message?: string;
 };
+export {};

package/dist/api.js

@@ -1,2 +1,2 @@
-import { C as e, S as t, _ as n, a as r, b as i, c as a, d as o, f as s, g as c, h as l, i as u, l as d, m as f, n as p, o as m, p as h, r as g, s as _, t as v, u as y, v as b, x, y as S } from "./messages-DhmdgtVq.js";
-export { n as API_ORIGIN_BY_ENV, l as AgUiEventType, v as AssessmentStatus, c as AssessmentSummaryCategory, p as ButtonType, b as CHATBOT_API_PATH, f as ChatbotApiClient, g as ContentComponent, u as ContentMarker, r as ContentType, S as DEFAULT_LOCAL_API_ORIGIN, i as ENVIRONMENTS, m as MessageIdentifier, _ as MessageKind, a as MessageSender, d as PHService, y as PiiQuestionType, o as QuestionType, x as REGIONS, s as RuleName, h as VideoQuestionType, t as buildChatbotBaseUrl, e as resolveApiOrigin };
+import { A as e, C as t, D as n, E as r, F as i, I as a, M as o, N as s, O as c, P as l, S as u, _ as d, a as f, b as p, c as m, d as h, f as g, g as _, h as v, i as y, j as b, k as x, l as S, m as C, n as w, o as T, p as E, r as D, s as O, t as k, u as A, v as j, w as M, x as N, y as P } from "./client-DG-5x86F.js";
+export { e as API_ORIGIN_BY_ENV, w as AgUiEventType, g as AssessmentStatus, D as AssessmentSummaryCategory, E as ButtonType, b as CHATBOT_API_PATH, k as ChatbotApiClient, C as ContentComponent, v as ContentMarker, _ as ContentType, y as CustomerSatisfactionFieldType, o as DEFAULT_LOCAL_API_ORIGIN, s as ENVIRONMENTS, f as FormType, d as MessageIdentifier, j as MessageKind, P as MessageSender, p as PHService, T as PiiFormFieldKind, O as PiiFormWireType, N as PiiQuestionType, u as QuestionType, l as REGIONS, t as RuleName, r as SessionLapsedError, n as UnauthorizedError, M as VideoQuestionType, i as buildChatbotBaseUrl, m as isCustomerSatisfactionFormMessage, S as isCustomerSatisfactionResponsesMessage, c as isNotFound, A as isPiiFormMessage, h as isPiiResponsesMessage, x as isUnauthorized, a as resolveApiOrigin };