@kontourai/survey 6.1.0 → 8.0.0

package/dist/src/review-workbench/review-queue-session.js

@@ -4,6 +4,71 @@ import { checkEditedValueForItem } from "./edited-value.js";
 import { assertSoleCandidateId, reviewResourceApiVersion, } from "../../src/review-resource.js";
 export const reviewWorkbenchSessionStorageKey = "kontourai.survey.review-workbench.session-events.v1";
 export const defaultReviewSessionName = "review-workbench-session";
+/** Whether the session hides confidence and verifier results from its reviewer. */
+export function isScoreBlind(session) {
+    return session.presentation?.scoreBlind === true;
+}
+/**
+ * Throws unless the session's presentation and sampling are well formed:
+ * `scoreBlind` a boolean, and a `random-audit` sampling with a rate in (0, 1]
+ * and a non-empty seed. Unknown keys are refused so a decision never records
+ * a condition nothing reads.
+ */
+export function assertReviewSessionConditions(session) {
+    const { presentation, sampling } = session;
+    if (presentation !== undefined) {
+        if (!isPlainRecord(presentation) || Object.keys(presentation).join(",") !== "scoreBlind" || typeof presentation.scoreBlind !== "boolean") {
+            throw new Error("Review session presentation must be { scoreBlind: boolean }.");
+        }
+    }
+    if (sampling !== undefined) {
+        if (!isPlainRecord(sampling))
+            throw new Error("Review session sampling must be an object.");
+        const keys = Object.keys(sampling).sort().join(",");
+        if (sampling.kind === "queue") {
+            if (keys !== "kind")
+                throw new Error("Review session sampling of kind queue takes no rate or seed.");
+        }
+        else if (sampling.kind === "random-audit") {
+            if (keys !== "kind,rate,seed")
+                throw new Error("Review session sampling of kind random-audit requires exactly rate and seed.");
+            assertAuditRate(sampling.rate);
+            assertAuditSeed(sampling.seed);
+        }
+        else {
+            throw new Error("Review session sampling kind must be queue or random-audit.");
+        }
+    }
+}
+/**
+ * The session conditions a decision event carries, or `undefined` for a
+ * session that declares none. Stamped on every decision event so replay can
+ * refuse events recorded under other conditions than the snapshot's: sighted
+ * events replayed over a blind snapshot, or a snapshot whose presentation was
+ * changed after decisions were recorded.
+ */
+export function sessionConditionsStamp(session) {
+    if (session.presentation === undefined && session.sampling === undefined)
+        return undefined;
+    return {
+        ...(session.presentation !== undefined ? { presentation: { scoreBlind: session.presentation.scoreBlind } } : {}),
+        ...(session.sampling !== undefined ? { sampling: { ...session.sampling } } : {}),
+    };
+}
+export function assertAuditRate(rate) {
+    if (typeof rate !== "number" || !Number.isFinite(rate) || rate <= 0 || rate > 1) {
+        throw new Error("A random-audit rate must be a number greater than 0 and at most 1.");
+    }
+}
+export function assertAuditSeed(seed) {
+    if (typeof seed !== "string" || !AUDIT_SEED.test(seed)) {
+        throw new Error("A random-audit seed must be a stable identity: 1-256 characters from letters, digits and . _ : @ / + ~ -, starting with a letter or digit.");
+    }
+}
+const AUDIT_SEED = /^[A-Za-z0-9][A-Za-z0-9._:@/+~-]{0,255}$/;
+function isPlainRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export const workbenchDecisionDefinitions = {
     "accept-proposed": {
         label: "Accept proposed",
@@ -11,6 +76,12 @@ export const workbenchDecisionDefinitions = {
         candidateRole: "proposed",
         status: "verified",
     },
+    "select-proposed": {
+        label: "Use this value",
+        effect: "The chosen value becomes the verified review outcome; the other proposed values were seen and not chosen.",
+        candidateRole: "proposed",
+        status: "verified",
+    },
     "keep-current": {
         label: "Keep current",
         effect: "Current value remains the verified review outcome.",
@@ -58,8 +129,11 @@ export function currentReviewWorkbenchState(session) {
         decision: session.decisionsByItemName[item.metadata.name],
         editedValue: session.editedValuesByItemName?.[item.metadata.name],
         attemptEvidenceIds: session.attemptEvidenceIdsByItemName?.[item.metadata.name],
+        selectedCandidateId: session.selectedCandidateIdsByItemName?.[item.metadata.name],
         reviewedAt: session.reviewedAt,
         actorId: session.actorId,
+        ...(session.presentation !== undefined ? { presentation: session.presentation } : {}),
+        ...(session.sampling !== undefined ? { sampling: session.sampling } : {}),
     };
 }
 export function currentReviewItem(session) {
@@ -77,7 +151,7 @@ export function deriveQueueRowStatus(item, session) {
     if (decision === "could-not-confirm") {
         return "could-not-confirm";
     }
-    if (decision === "accept-proposed" || decision === "keep-current" || item.spec.candidateSetStatus === "resolved") {
+    if (decision === "accept-proposed" || decision === "select-proposed" || decision === "keep-current" || item.spec.candidateSetStatus === "resolved") {
         return "resolved";
     }
     if (item.spec.candidateSetStatus === "escalated") {
@@ -99,7 +173,7 @@ export function nextUnresolvedItemName(session) {
 export function reviewSessionSummary(session) {
     return session.items.reduce((summary, item) => {
         const decision = session.decisionsByItemName[item.metadata.name];
-        if (decision === "accept-proposed") {
+        if (decision === "accept-proposed" || decision === "select-proposed") {
             return { ...summary, accepted: summary.accepted + 1 };
         }
         if (decision === "keep-current") {
@@ -176,7 +250,14 @@ const VALUE_NEUTRAL_DECISIONS = new Set(["reject-proposed", "could-not-confirm"]
  * {@link decisionCandidateId} is `undefined` for it, so the decision, its
  * session events and the canonical projection name no candidate.
  */
-export function candidateForDecision(item, decision) {
+export function candidateForDecision(item, decision, selectedCandidateId) {
+    if (decision === "select-proposed") {
+        const issue = conflictSelectionIssue(item, selectedCandidateId);
+        if (issue) {
+            throw new Error(issue);
+        }
+        return item.spec.candidates.find((entry) => entry.id === selectedCandidateId);
+    }
     const definition = workbenchDecisionDefinitions[decision];
     const matches = item.spec.candidates.filter((entry) => entry.role === definition.candidateRole);
     const candidate = matches[0];
@@ -189,6 +270,45 @@ export function candidateForDecision(item, decision) {
     assertSoleCandidateId(item, candidate.id);
     return candidate;
 }
+/**
+ * Why a `select-proposed` decision naming `candidateId` cannot be recorded on
+ * this item, or `undefined` when it can.
+ *
+ * The choice must name, by a unique id, one of the item's `proposed`
+ * candidates, and the item must hold at least two of them: choosing "over a
+ * rival" on an item with no rival would record a conflict that never existed
+ * (use `accept-proposed` there). Proposals excluded at import are not
+ * candidates, so they can never be chosen.
+ */
+export function conflictSelectionIssue(item, candidateId) {
+    const proposed = item.spec.candidates.filter((entry) => entry.role === "proposed");
+    if (proposed.length < 2) {
+        return `ReviewItem ${item.metadata.name} has ${proposed.length} proposed candidate${proposed.length === 1 ? "" : "s"}; select-proposed chooses between conflicting proposed values, so it needs at least two.`;
+    }
+    if (!candidateId) {
+        return `ReviewItem ${item.metadata.name}: select-proposed must name the chosen candidate id.`;
+    }
+    const matches = item.spec.candidates.filter((entry) => entry.id === candidateId);
+    if (matches.length === 0) {
+        return `ReviewItem ${item.metadata.name} has no candidate ${candidateId}; select-proposed can only choose one of its proposed candidates.`;
+    }
+    if (matches.length > 1) {
+        return `ReviewItem ${item.metadata.name} has ${matches.length} candidates with id ${candidateId}; candidate ids must be unique.`;
+    }
+    if (matches[0].role !== "proposed") {
+        return `ReviewItem ${item.metadata.name} candidate ${candidateId} has role ${matches[0].role ?? "none"}; select-proposed can only choose a proposed candidate.`;
+    }
+    return undefined;
+}
+/**
+ * The proposed candidates a `select-proposed` decision saw and did not choose,
+ * in item order. Empty for every other decision.
+ */
+export function unchosenProposedCandidates(item, decision, selectedCandidateId) {
+    return decision === "select-proposed"
+        ? item.spec.candidates.filter((entry) => entry.role === "proposed" && entry.id !== selectedCandidateId)
+        : [];
+}
 /** Whether a decision on this item selects no candidate at all (see {@link candidateForDecision}). */
 export function decisionSelectsNoCandidate(item, decision) {
     const role = workbenchDecisionDefinitions[decision].candidateRole;
@@ -198,8 +318,8 @@ export function decisionSelectsNoCandidate(item, decision) {
  * The candidate id a decision records: the selected candidate's, or
  * `undefined` when the decision selects no candidate.
  */
-export function decisionCandidateId(item, decision) {
-    const candidate = candidateForDecision(item, decision);
+export function decisionCandidateId(item, decision, selectedCandidateId) {
+    const candidate = candidateForDecision(item, decision, selectedCandidateId);
     return decisionSelectsNoCandidate(item, decision) ? undefined : candidate.id;
 }
 /**
@@ -210,8 +330,8 @@ export function decisionCandidateId(item, decision) {
  * this rule; this helper exists for callers deriving the value from raw session
  * state directly.
  */
-export function effectiveValueForDecision(item, decision, editedValue) {
-    const candidate = candidateForDecision(item, decision);
+export function effectiveValueForDecision(item, decision, editedValue, selectedCandidateId) {
+    const candidate = candidateForDecision(item, decision, selectedCandidateId);
     return decision === "accept-proposed" && editedValue !== undefined ? editedValue : candidate.value;
 }
 export function selectedCandidateRole(state) {
@@ -287,7 +407,7 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
         if (decision === "could-not-confirm" && !note?.trim()) {
             throw new Error(`ReviewItem ${item.metadata.name} could not confirm requires a non-empty reason.`);
         }
-        const candidateId = decisionCandidateId(item, decision);
+        const candidateId = decisionCandidateId(item, decision, session.selectedCandidateIdsByItemName?.[item.metadata.name]);
         const definition = workbenchDecisionDefinitions[decision];
         const reviewDecisionName = `${item.metadata.name}-${decision}`;
         // Carry the reviewer's inline edit in the event itself (accept-proposed
@@ -307,9 +427,13 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
             actor: session.actorId,
             reviewedAt: session.reviewedAt,
         });
-        const data = editedValue !== undefined
-            ? { workbenchDecision: decision, workbenchEditedValue: editedValue }
-            : { workbenchDecision: decision, ...(attemptEvidenceIds?.length ? { attemptEvidenceIds } : {}) };
+        const conditions = sessionConditionsStamp(session);
+        const data = {
+            ...(editedValue !== undefined
+                ? { workbenchDecision: decision, workbenchEditedValue: editedValue }
+                : { workbenchDecision: decision, ...(attemptEvidenceIds?.length ? { attemptEvidenceIds } : {}) }),
+            ...(conditions ? { sessionConditions: conditions } : {}),
+        };
         events.push(buildReviewSessionEvent(session, {
             sessionName,
             sequence: events.length + 1,
@@ -383,11 +507,13 @@ export function replayReviewSessionEvents(startState, events) {
                 const { [itemName]: _removedDecision, ...remainingDecisions } = session.decisionsByItemName;
                 const { [itemName]: _removedEdit, ...remainingEdits } = session.editedValuesByItemName ?? {};
                 const { [itemName]: _removedAttempts, ...remainingAttempts } = session.attemptEvidenceIdsByItemName ?? {};
+                const { [itemName]: _removedSelection, ...remainingSelections } = session.selectedCandidateIdsByItemName ?? {};
                 return {
                     ...session,
                     decisionsByItemName: remainingDecisions,
                     editedValuesByItemName: remainingEdits,
                     attemptEvidenceIdsByItemName: remainingAttempts,
+                    ...(session.selectedCandidateIdsByItemName ? { selectedCandidateIdsByItemName: remainingSelections } : {}),
                 };
             }
             const decision = workbenchDecisionFromEvent(event);
@@ -419,6 +545,15 @@ export function replayReviewSessionEvents(startState, events) {
             else {
                 delete attemptEvidenceIdsByItemName[itemName];
             }
+            // A choice between conflicting values is the event's candidateId: that
+            // id is the authority for select-proposed (validated replay checks it).
+            const selectedCandidateIdsByItemName = { ...session.selectedCandidateIdsByItemName };
+            if (decision === "select-proposed" && event.spec.candidateId) {
+                selectedCandidateIdsByItemName[itemName] = event.spec.candidateId;
+            }
+            else {
+                delete selectedCandidateIdsByItemName[itemName];
+            }
             return {
                 ...session,
                 decisionsByItemName: {
@@ -427,6 +562,7 @@ export function replayReviewSessionEvents(startState, events) {
                 },
                 editedValuesByItemName,
                 attemptEvidenceIdsByItemName,
+                ...(session.selectedCandidateIdsByItemName || decision === "select-proposed" ? { selectedCandidateIdsByItemName } : {}),
             };
         }
         return session;

package/dist/src/review-workbench/review-session-replay.d.ts

@@ -1,6 +1,6 @@
 import type { ReviewSessionEvent } from "../review-resource.js";
 import { type ReviewQueueSessionState } from "./review-queue-session.js";
-export type ReviewSessionReplayIssueCode = "invalid-sequence" | "duplicate-sequence" | "non-contiguous-sequence" | "unknown-active-item" | "unknown-review-item" | "unknown-candidate" | "missing-review-item" | "invalid-workbench-decision" | "decision-candidate-mismatch" | "decision-status-mismatch" | "decision-resolution-mismatch" | "missing-resolution-reason" | "edited-value-not-editable" | "edited-value-type-mismatch";
+export type ReviewSessionReplayIssueCode = "invalid-sequence" | "duplicate-sequence" | "non-contiguous-sequence" | "unknown-active-item" | "unknown-review-item" | "unknown-candidate" | "missing-review-item" | "invalid-workbench-decision" | "decision-candidate-mismatch" | "invalid-conflict-selection" | "decision-status-mismatch" | "decision-resolution-mismatch" | "missing-resolution-reason" | "edited-value-not-editable" | "edited-value-type-mismatch" | "session-conditions-mismatch";
 export interface ReviewSessionReplayIssue {
     readonly code: ReviewSessionReplayIssueCode;
     readonly eventName: string;
@@ -37,6 +37,16 @@ export type ReviewSessionReplayWarning = {
     readonly refusedCode: "edited-value-not-editable" | "edited-value-type-mismatch";
     readonly editedValue: unknown;
     readonly message: string;
+} | {
+    /**
+     * The session's items came from an extraction import, but the apply
+     * boundary was not given the import record to check them against (see
+     * `DeriveServerReviewSessionApplyResultOptions.extractionImport`). Emitted
+     * by the server apply boundary, never by replay itself.
+     */
+    readonly code: "unverified-extraction-queue";
+    readonly itemNames: readonly string[];
+    readonly message: string;
 };
 /**
  * Lists the legacy text edits replay converts to typed values, and refused

package/dist/src/review-workbench/review-session-replay.js

@@ -1,5 +1,6 @@
-import { candidateForDecision, decisionSelectsNoCandidate, isClearedWorkbenchDecisionEvent, workbenchDecisionDefinitions, } from "./review-queue-session.js";
+import { candidateForDecision, conflictSelectionIssue, decisionSelectsNoCandidate, isClearedWorkbenchDecisionEvent, sessionConditionsStamp, workbenchDecisionDefinitions, } from "./review-queue-session.js";
 import { checkEditedValueForItem } from "./edited-value.js";
+import { canonicalJson } from "./canonical.js";
 export function validateReviewSessionEventsForSnapshot(snapshot, events) {
     const itemsByName = new Map(snapshot.items.map((item) => [item.metadata.name, item]));
     const sequenceIssues = validateEventSequence(events);
@@ -44,6 +45,19 @@ export function validateReviewSessionEventsForSnapshot(snapshot, events) {
         }
         else if (event.spec.eventType === "decision-changed" || event.spec.eventType === "decision-submitted") {
             const decision = replayableWorkbenchDecision(event.spec.data?.workbenchDecision);
+            // A decision recorded under other presentation or sampling than the
+            // snapshot's must not be replayed as if made under the snapshot's.
+            const expectedConditions = sessionConditionsStamp(snapshot);
+            const carried = event.spec.data?.sessionConditions;
+            if (decision && canonicalJson(carried ?? null) !== canonicalJson(expectedConditions ?? null)) {
+                issues.push({
+                    ...eventRef,
+                    code: "session-conditions-mismatch",
+                    reviewItemName,
+                    candidateId: event.spec.candidateId,
+                    message: `ReviewSessionEvent ${event.metadata.name} was recorded under session conditions ${JSON.stringify(carried ?? "none")}, but the snapshot's are ${JSON.stringify(expectedConditions ?? "none")}.`,
+                });
+            }
             if (!decision) {
                 issues.push({
                     ...eventRef,
@@ -53,6 +67,40 @@ export function validateReviewSessionEventsForSnapshot(snapshot, events) {
                     message: `ReviewSessionEvent ${event.metadata.name} is a decision event but does not include a replayable workbench decision.`,
                 });
             }
+            else if (itemName && itemsByName.has(itemName) && decision === "select-proposed") {
+                // The event's candidateId is the choice; it must name one proposed
+                // candidate of an item that holds a conflict.
+                const item = itemsByName.get(itemName);
+                const selectionIssue = conflictSelectionIssue(item, event.spec.candidateId);
+                if (selectionIssue) {
+                    issues.push({
+                        ...eventRef,
+                        code: "invalid-conflict-selection",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name}: ${selectionIssue}`,
+                    });
+                }
+                const expectedStatus = workbenchDecisionDefinitions[decision].status;
+                if (event.spec.status !== expectedStatus) {
+                    issues.push({
+                        ...eventRef,
+                        code: "decision-status-mismatch",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects status ${expectedStatus}, but references ${event.spec.status ?? "no status"}.`,
+                    });
+                }
+                if (event.spec.resolution !== undefined) {
+                    issues.push({
+                        ...eventRef,
+                        code: "decision-resolution-mismatch",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects resolution none, but references ${event.spec.resolution}.`,
+                    });
+                }
+            }
             else if (itemName && itemsByName.has(itemName)) {
                 const item = itemsByName.get(itemName);
                 const expectedCandidate = item ? candidateForDecision(item, decision) : undefined;

package/dist/src/review-workbench/review-workbench-css.generated.js

@@ -617,6 +617,30 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
 .survey-workbench-embed .chip.rejected{ color: var(--k-negative); background: var(--k-negative-wash); }
 .survey-workbench-embed .chip.could-not-confirm{ color: var(--k-caution); background: var(--k-caution-wash); }
 
+/* Field-state panel: one row per field, content and lifecycle derived from
+   the records, never stored labels. A field that was not read is listed. */
+.survey-workbench-embed .field-states{ padding: var(--k-space-3, 12px) 1rem; border-bottom: 1px solid var(--k-line); background: var(--k-panel); }
+.survey-workbench-embed .field-states h2{ margin: 0 0 8px; font-size: 13px; font-weight: 700; color: var(--k-text); }
+.survey-workbench-embed .field-states ul{ list-style: none; margin: 0; padding: 0; display: grid; gap: 6px; }
+.survey-workbench-embed .field-states-lead{ margin: 0 0 8px; font-size: 13px; line-height: 1.45; color: var(--k-caution); }
+.survey-workbench-embed .field-state-row{ display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 4px 12px; align-items: center; padding: 6px 0; border-top: 1px solid var(--k-line); }
+.survey-workbench-embed .field-state-row:first-child{ border-top: 0; }
+.survey-workbench-embed .field-state-name{ font-family: var(--k-font-mono, ui-monospace, monospace); font-size: 12px; color: var(--k-text); overflow-wrap: anywhere; }
+.survey-workbench-embed .field-state-chips{ display: inline-flex; flex-wrap: wrap; gap: 6px; justify-content: flex-end; }
+.survey-workbench-embed .field-state-note{ grid-column: 1 / -1; font-size: 12px; color: var(--k-muted); }
+.survey-workbench-embed .field-state-note.signal{ color: var(--k-caution); }
+.survey-workbench-embed .chip.state-content.value{ color: var(--k-positive); background: var(--k-positive-wash); }
+.survey-workbench-embed .chip.state-content.conflicting,
+.survey-workbench-embed .chip.state-content.excluded,
+.survey-workbench-embed .chip.state-content.not_covered{ color: var(--k-caution); background: var(--k-caution-wash); }
+.survey-workbench-embed .chip.state-content.unsupported{ color: var(--k-negative); background: var(--k-negative-wash); }
+.survey-workbench-embed .chip.state-content.none,
+.survey-workbench-embed .chip.state-lifecycle.superseded{ color: var(--k-muted); background: var(--k-sunken); }
+.survey-workbench-embed .chip.state-lifecycle.pending{ color: var(--k-brand); background: var(--k-brand-wash); }
+.survey-workbench-embed .chip.state-lifecycle.accepted{ color: var(--k-positive); background: var(--k-positive-wash); }
+.survey-workbench-embed .chip.state-lifecycle.rejected{ color: var(--k-negative); background: var(--k-negative-wash); }
+.survey-workbench-embed .chip.state-lifecycle.could_not_confirm{ color: var(--k-caution); background: var(--k-caution-wash); }
+
 .survey-workbench-embed .frow1 .push{
   margin-left: auto;
 }
@@ -835,6 +859,106 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
   font-size: 12px;
 }
 
+/* A queue that came from an extraction import but was not checked against
+   it (unverified), or that does not match it (diverges, shown instead of the
+   queue). */
+.survey-workbench-embed .queue-attestation{
+  display: flex;
+  align-items: flex-start;
+  gap: var(--k-space-2);
+  margin: 0 0 var(--k-space-3);
+  padding: var(--k-space-2) var(--k-space-3);
+  border-radius: 9px;
+  font-size: 13px;
+  line-height: 1.45;
+  color: var(--k-caution);
+  background: var(--k-caution-wash);
+}
+
+.survey-workbench-embed .queue-attestation svg{
+  flex: none;
+  margin-top: 2px;
+}
+
+.survey-workbench-embed .queue-attestation.diverges{
+  color: var(--k-negative);
+  background: var(--k-negative-wash);
+}
+
+/* A score-blind session: an informational note, not a warning. */
+.survey-workbench-embed .queue-attestation.score-blind{
+  color: var(--k-active);
+  background: var(--k-active-soft);
+}
+
+/* Conflicting proposed values: each value is listed with its own choice
+   control until the field is decided, then marked chosen or not chosen. */
+.survey-workbench-embed .conflict-values ul{
+  list-style: none;
+  margin: var(--k-space-2) 0 0;
+  padding: 0;
+  display: grid;
+  gap: var(--k-space-2);
+}
+
+.survey-workbench-embed .conflict-values li{
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--k-space-3);
+  flex-wrap: wrap;
+  padding: var(--k-space-2) var(--k-space-3);
+  border: 1px solid var(--k-line);
+  border-radius: 9px;
+}
+
+.survey-workbench-embed .conflict-values li[data-chosen="true"]{
+  border-color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .conflict-values .conflict-text{
+  display: inline-flex;
+  align-items: baseline;
+  gap: var(--k-space-2);
+  flex-wrap: wrap;
+  min-width: 0;
+}
+
+.survey-workbench-embed .conflict-values .vtext{
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values q{
+  color: var(--k-muted);
+  font-size: 12.5px;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values .btn.choose{
+  min-height: 36px;
+  padding: 0 14px;
+  font-size: 13px;
+}
+
+.survey-workbench-embed .choice-tag{
+  font-size: 12px;
+  font-weight: 600;
+  padding: 2px 8px;
+  border-radius: 999px;
+}
+
+.survey-workbench-embed .choice-tag.chosen{
+  color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .choice-tag.not-chosen{
+  color: var(--k-muted);
+  background: var(--k-sunken);
+}
+
 .survey-workbench-embed .excerpt-verification,
 .survey-workbench-embed .support-verification{
   margin: 0;
@@ -1327,6 +1451,8 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
 /* The diff-collapse must also hold in host contexts without a query container
    (e.g. an embed that doesn't establish \`container-type\`): fall back to viewport. */
 @media (max-width: 620px) {
+  .survey-workbench-embed .field-state-row{ grid-template-columns: minmax(0, 1fr); }
+  .survey-workbench-embed .field-state-chips{ justify-content: flex-start; }
   .survey-workbench-embed .diff{
     grid-template-columns: 1fr;
   }

package/dist/src/review-workbench/review-workbench-element.d.ts

@@ -34,6 +34,7 @@
  */
 import { type ReviewQueueSessionState, type ReviewWorkbenchState } from "./review-workbench.js";
 import type { ReviewPresentationAdapter } from "./review-presentation.js";
+import type { ExtractionEnvelopeImport, ExtractionEnvelopeImportResult } from "../extraction-envelope.js";
 import { type ExtractionInspectorInput } from "./extraction-inspector.js";
 export declare class SurveyReviewWorkbenchElement extends HTMLElement {
     #private;
@@ -45,6 +46,15 @@ export declare class SurveyReviewWorkbenchElement extends HTMLElement {
     /** Optional presentation adapter for custom labels, value summaries, and links. */
     get presentationAdapter(): ReviewPresentationAdapter | undefined;
     set presentationAdapter(value: ReviewPresentationAdapter | undefined);
+    /**
+     * The extraction import record the queue was built from, as stored beside
+     * it. The workbench checks the queue against it (see
+     * `MountReviewWorkbenchOptions.extractionImport`). When unset, the import of
+     * a single-import `extractionInspector` is used; with neither, a queue whose
+     * items came from an extraction import shows an "Unverified queue" notice.
+     */
+    get extractionImport(): ExtractionEnvelopeImport | ExtractionEnvelopeImportResult | null;
+    set extractionImport(value: ExtractionEnvelopeImport | ExtractionEnvelopeImportResult | null | undefined);
     /** Optional read-only source pane attached to this workbench's existing review lifecycle. */
     get extractionInspector(): ExtractionInspectorInput | null;
     set extractionInspector(value: ExtractionInspectorInput | null | undefined);

package/dist/src/review-workbench/review-workbench-element.js

@@ -169,6 +169,7 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
     #session = null;
     #presentationAdapter = undefined;
     #extractionInspector = null;
+    #extractionImport = null;
     #unmountInspector;
     #root;
     #mountRoot;
@@ -340,6 +341,18 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
         this.#presentationAdapter = value;
         this.#remount();
     }
+    /**
+     * The extraction import record the queue was built from, as stored beside
+     * it. The workbench checks the queue against it (see
+     * `MountReviewWorkbenchOptions.extractionImport`). When unset, the import of
+     * a single-import `extractionInspector` is used; with neither, a queue whose
+     * items came from an extraction import shows an "Unverified queue" notice.
+     */
+    get extractionImport() { return this.#extractionImport; }
+    set extractionImport(value) {
+        this.#extractionImport = value ?? null;
+        this.#remount();
+    }
     /** Optional read-only source pane attached to this workbench's existing review lifecycle. */
     get extractionInspector() { return this.#extractionInspector; }
     set extractionInspector(value) {
@@ -423,9 +436,14 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
             this.#renderEmpty();
             return;
         }
-        const options = this.#presentationAdapter
-            ? { presentationAdapter: this.#presentationAdapter }
-            : {};
+        const inspectorImport = this.#extractionInspector && !("imports" in this.#extractionInspector)
+            ? this.#extractionInspector.importResult
+            : undefined;
+        const extractionImport = this.#extractionImport ?? inspectorImport;
+        const options = {
+            ...(this.#presentationAdapter ? { presentationAdapter: this.#presentationAdapter } : {}),
+            ...(extractionImport ? { extractionImport } : {}),
+        };
         this.#applyThemeClasses();
         mountReviewWorkbench(this.#mountRoot, this.#session, options);
         this.#unmountInspector?.();