@case-framework/survey-assistant 0.2.0 → 0.2.1

package/dist/{engine-DQrCO_ur.mjs → engine-0AJrv0hI.mjs}

@@ -1,7 +1,7 @@
-import { P as rawSurveyDocumentSchema, c as surveyAssistantTurnFinalSchema, u as surveyChangeSetSchema } from "./protocol-7EEgcYja.mjs";
-import { n as assertSurveyAssistantCapabilities } from "./capabilities-DZ0a_o2y.mjs";
+import { P as rawSurveyDocumentSchema, c as surveyAssistantTurnFinalSchema, u as surveyChangeSetSchema } from "./protocol-DpCYmCjr.mjs";
+import { n as assertSurveyAssistantCapabilities } from "./capabilities-DKbNCnBf.mjs";
 import { z } from "zod";
-import { ContentType, Expression, ExpressionType, FunctionExpressionNames, JsonPatchError, ReservedSurveyItemTypes, SurveyTranslations, ValueReferenceMethod, ValueType, applyJsonPatch, generateId, getContentPlainText, isContentEmpty, parseJsonPointer, structuredCloneMethod } from "@case-framework/survey-core";
+import { ContentType, Expression, ExpressionType, FunctionExpressionNames, JsonPatchError, ReservedSurveyItemTypes, SurveyItemTranslations, SurveyTranslations, ValueReferenceMethod, ValueType, applyJsonPatch, generateId, getContentPlainText, isContentEmpty, parseJsonPointer, structuredCloneMethod } from "@case-framework/survey-core";
 //#region src/engine/context.ts
 const isRecord$6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const asString$1 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
@@ -1938,6 +1938,7 @@ const normalizeSurveyChangeOperations = (operations, defaultLocale) => operation
 //#region src/engine/operations.ts
 const ITEM_KEY_PATTERN = /^[A-Za-z0-9_-]+$/;
 const MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL = 200;
+const MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT = 1e3;
 const CHOICE_ITEM_TYPE = "choiceItem";
 const FORM_ITEM_TYPE = "formItem";
 const CHOICE_OPTION_LABEL_CONTENT_KEY_PATTERN = /^options\.([^.]+)\.label$/;
@@ -3370,7 +3371,7 @@ const getDeletedAncestor = (itemId, parentByChildId, deletedItemIds) => {
 };
 const buildSurveyDocumentVersion = (snapshot) => ({ ...snapshot.version });
 const resolveEngineContext = (snapshot) => "document" in snapshot ? snapshot : createSurveyAssistantEngineContext(snapshot);
-const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
+const validateSurveyOperations = ({ maxOperations = 200, operations, snapshot: snapshotInput }) => {
 	if (!snapshotInput) return createEmptyValidationResult(createIssue({
 		code: "missing-snapshot",
 		message: "No live editor snapshot was provided for this assistant turn."
@@ -3380,9 +3381,9 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 		code: "empty-operations",
 		message: "No survey change operations were provided."
 	}), operations);
-	if (operations.length > 200) return createEmptyValidationResult(createIssue({
+	if (operations.length > maxOperations) return createEmptyValidationResult(createIssue({
 		code: "too-many-operations",
-		message: `At most 200 operations can be proposed at once.`
+		message: `At most ${maxOperations} operations can be validated in this change set.`
 	}), operations);
 	const surveyJsonPatchOperations = operations.filter(isSurveyJsonPatchOperation);
 	if (surveyJsonPatchOperations.length > 0) {
@@ -4558,8 +4559,421 @@ const validateSurveyOperations = ({ operations, snapshot: snapshotInput }) => {
 		normalizedOperations
 	};
 };
-const createSurveyChangeSet = ({ operations, snapshot, summary, turnId }) => {
+const buildDraftContent = ({ content, plainText }) => content ? structuredCloneMethod(content) : {
+	type: ContentType.md,
+	content: plainText ?? ""
+};
+const updateDraftItemTranslations = ({ itemId, survey, translations }) => {
+	if (!translations?.length) return;
+	const surveyTranslations = new SurveyTranslations(survey.translations);
+	const itemTranslations = surveyTranslations.getItemTranslations(itemId)?.clone() ?? new SurveyItemTranslations();
+	for (const translation of translations) itemTranslations.setContent(translation.locale, translation.contentKey, buildDraftContent(translation));
+	surveyTranslations.setItemTranslations(itemId, itemTranslations);
+	survey.translations = surveyTranslations.serialize();
+};
+const removeDraftTranslationPrefix = ({ itemId, prefix, survey }) => {
+	const surveyTranslations = new SurveyTranslations(survey.translations);
+	const itemTranslations = surveyTranslations.getItemTranslations(itemId)?.clone();
+	if (!itemTranslations) return;
+	itemTranslations.removeContentKeysWithPrefix(prefix);
+	surveyTranslations.setItemTranslations(itemId, itemTranslations.compact());
+	survey.translations = surveyTranslations.serialize();
+};
+/**
+* Applies already-normalized, validated operations to a request-local raw
+* survey. This is simulation only; the editor remains the final mutation and
+* undo/redo owner.
+*/
+const applyValidatedSurveyOperationsToDraft = ({ operations, survey: inputSurvey }) => {
+	let survey = structuredCloneMethod(inputSurvey);
+	const getItem = (itemId) => {
+		const item = survey.surveyItems.find((candidate) => candidate.id === itemId);
+		if (!item) throw new Error(`Draft item "${itemId}" was not found.`);
+		return item;
+	};
+	const replaceItem = (item) => {
+		const index = survey.surveyItems.findIndex((candidate) => candidate.id === item.id);
+		if (index < 0) throw new Error(`Draft item "${item.id}" was not found.`);
+		survey.surveyItems[index] = item;
+	};
+	for (const operation of operations) {
+		if (operation.kind === "survey-json-patch") {
+			survey = applyJsonPatch(survey, operation.patches);
+			continue;
+		}
+		switch (operation.kind) {
+			case "create-item": {
+				const item = structuredCloneMethod(operation.item);
+				survey.surveyItems.push(item);
+				const parent = getItem(operation.target.parentItemId);
+				const children = getGroupChildren(parent);
+				children.splice(Math.min(operation.target.index ?? children.length, children.length), 0, item.id);
+				replaceItem({
+					...parent,
+					config: {
+						...isRecord$2(parent.config) ? parent.config : {},
+						items: children
+					}
+				});
+				updateDraftItemTranslations({
+					itemId: item.id,
+					survey,
+					translations: operation.translations
+				});
+				break;
+			}
+			case "update-item-key":
+				replaceItem({
+					...getItem(operation.itemId),
+					key: operation.key
+				});
+				break;
+			case "update-item-label": {
+				const item = getItem(operation.itemId);
+				const metadata = { ...item.metadata ?? {} };
+				if (operation.itemLabel) metadata.itemLabel = operation.itemLabel;
+				else delete metadata.itemLabel;
+				replaceItem({
+					...item,
+					metadata: Object.keys(metadata).length ? metadata : void 0
+				});
+				break;
+			}
+			case "update-item-color": {
+				const item = getItem(operation.itemId);
+				replaceItem({
+					...item,
+					metadata: {
+						...item.metadata ?? {},
+						editorItemColor: operation.color
+					}
+				});
+				break;
+			}
+			case "update-item-translation":
+				updateDraftItemTranslations({
+					itemId: operation.itemId,
+					survey,
+					translations: [operation]
+				});
+				break;
+			case "update-placed-image": {
+				const surveyTranslations = new SurveyTranslations(survey.translations);
+				const itemTranslations = surveyTranslations.getItemTranslations(operation.itemId)?.clone() ?? new SurveyItemTranslations();
+				const content = itemTranslations.getContent(operation.locale, operation.contentKey);
+				if (content?.type !== ContentType.richText) throw new Error("Draft image placement is not rich text.");
+				let imageIndex = -1;
+				const blocks = content.doc.blocks.map((block) => {
+					if (block.type !== "image") return block;
+					imageIndex += 1;
+					if (imageIndex !== operation.imageIndex) return block;
+					const next = structuredCloneMethod(block);
+					const changes = operation.changes;
+					if (changes.source !== void 0) next.source = changes.source;
+					if (changes.alt !== void 0) if (changes.alt === null) delete next.alt;
+					else next.alt = changes.alt;
+					if (changes.caption !== void 0) if (changes.caption === null || changes.caption.length === 0) delete next.caption;
+					else next.caption = [{
+						type: "paragraph",
+						children: [{
+							type: "text",
+							text: changes.caption
+						}]
+					}];
+					const size = { ...next.size ?? {} };
+					for (const key of [
+						"width",
+						"height",
+						"maxWidth",
+						"maxHeight"
+					]) {
+						const value = changes[key];
+						if (value === null) delete size[key];
+						else if (value !== void 0) size[key] = value;
+					}
+					if (Object.keys(size).length) next.size = size;
+					else delete next.size;
+					if (changes.alignment === null) delete next.alignment;
+					else if (changes.alignment !== void 0) next.alignment = changes.alignment;
+					return next;
+				});
+				itemTranslations.setContent(operation.locale, operation.contentKey, {
+					...content,
+					doc: {
+						...content.doc,
+						blocks
+					}
+				});
+				surveyTranslations.setItemTranslations(operation.itemId, itemTranslations);
+				survey.translations = surveyTranslations.serialize();
+				break;
+			}
+			case "patch-item-config": {
+				const item = getItem(operation.itemId);
+				replaceItem({
+					...item,
+					config: applyJsonPatch(item.config ?? {}, operation.patches)
+				});
+				break;
+			}
+			case "add-choice-option": {
+				const item = getItem(operation.itemId);
+				const options = getChoiceOptionsFromRawItem(item);
+				options.splice(operation.index ?? options.length, 0, {
+					id: operation.option.id,
+					...operation.option.key ? { key: operation.option.key } : {}
+				});
+				replaceItem(withChoiceOptionsOnRawItem(item, options));
+				updateDraftItemTranslations({
+					itemId: item.id,
+					survey,
+					translations: [{
+						locale: operation.locale ?? "en",
+						contentKey: createChoiceOptionLabelContentKey(operation.option.id),
+						plainText: operation.option.label
+					}]
+				});
+				break;
+			}
+			case "update-choice-option-label":
+				updateDraftItemTranslations({
+					itemId: operation.itemId,
+					survey,
+					translations: [{
+						locale: operation.locale ?? "en",
+						contentKey: createChoiceOptionLabelContentKey(operation.optionId),
+						plainText: operation.label
+					}]
+				});
+				break;
+			case "remove-choice-option": {
+				const item = getItem(operation.itemId);
+				replaceItem(withChoiceOptionsOnRawItem(item, getChoiceOptionsFromRawItem(item).filter((option) => option.id !== operation.optionId)));
+				removeDraftTranslationPrefix({
+					itemId: item.id,
+					prefix: `options.${operation.optionId}`,
+					survey
+				});
+				removeDraftTranslationPrefix({
+					itemId: item.id,
+					prefix: `embeddedForms.${operation.optionId}`,
+					survey
+				});
+				break;
+			}
+			case "reorder-choice-options": {
+				const item = getItem(operation.itemId);
+				const options = new Map(getChoiceOptionsFromRawItem(item).map((option) => [option.id, option]));
+				replaceItem(withChoiceOptionsOnRawItem(item, operation.optionIds.map((optionId) => options.get(optionId))));
+				break;
+			}
+			case "set-embedded-form":
+			case "remove-embedded-form": {
+				const item = getItem(operation.itemId);
+				const options = getChoiceOptionsFromRawItem(item);
+				const optionIndex = options.findIndex((option) => option.id === operation.optionId);
+				const option = { ...options[optionIndex] };
+				if (operation.kind === "set-embedded-form") option.embeddedForm = operation.form;
+				else {
+					delete option.embeddedForm;
+					delete option.embeddedFormItemId;
+				}
+				options[optionIndex] = option;
+				replaceItem(withChoiceOptionsOnRawItem(item, options));
+				if (operation.kind === "set-embedded-form") updateDraftItemTranslations({
+					itemId: item.id,
+					survey,
+					translations: operation.translations
+				});
+				else removeDraftTranslationPrefix({
+					itemId: item.id,
+					prefix: `embeddedForms.${operation.optionId}`,
+					survey
+				});
+				break;
+			}
+			case "upsert-form-field-group":
+			case "remove-form-field-group":
+			case "reorder-form-field-groups":
+			case "upsert-form-field":
+			case "remove-form-field":
+			case "move-form-field": {
+				const item = getItem(operation.target.itemId);
+				let groups = getFormFieldGroupsForTarget(item, operation.target.optionId) ?? [];
+				groups = groups.map((group) => ({
+					...group,
+					fields: [...group.fields]
+				}));
+				if (operation.kind === "upsert-form-field-group") {
+					const index = groups.findIndex((group) => group.id === operation.group.id);
+					const group = normalizeFormFieldGroupRecord({
+						...index >= 0 ? groups[index] : {},
+						...operation.group
+					});
+					if (index >= 0) groups[index] = group;
+					else groups.splice(operation.index ?? groups.length, 0, group);
+					updateDraftItemTranslations({
+						itemId: item.id,
+						survey,
+						translations: operation.translations
+					});
+				} else if (operation.kind === "remove-form-field-group") {
+					groups = groups.filter((group) => group.id !== operation.groupId);
+					removeDraftTranslationPrefix({
+						itemId: item.id,
+						prefix: `${operation.target.optionId ? `embeddedForms.${operation.target.optionId}.` : ""}fieldGroups.${operation.groupId}`,
+						survey
+					});
+				} else if (operation.kind === "reorder-form-field-groups") {
+					const byId = new Map(groups.map((group) => [group.id, group]));
+					groups = operation.groupIds.map((groupId) => byId.get(groupId));
+				} else if (operation.kind === "upsert-form-field") {
+					let field;
+					for (const group of groups) {
+						const index = group.fields.findIndex((candidate) => candidate.id === operation.field.id);
+						if (index >= 0) [field] = group.fields.splice(index, 1);
+					}
+					const group = groups.find((candidate) => candidate.id === operation.groupId);
+					group.fields.splice(operation.index ?? group.fields.length, 0, {
+						...field,
+						...operation.field
+					});
+					updateDraftItemTranslations({
+						itemId: item.id,
+						survey,
+						translations: operation.translations
+					});
+				} else {
+					let field;
+					for (const group of groups) {
+						const index = group.fields.findIndex((candidate) => candidate.id === operation.fieldId);
+						if (index >= 0) [field] = group.fields.splice(index, 1);
+					}
+					if (operation.kind === "move-form-field") {
+						const group = groups.find((candidate) => candidate.id === operation.targetGroupId);
+						group.fields.splice(operation.index ?? group.fields.length, 0, field);
+					} else removeDraftTranslationPrefix({
+						itemId: item.id,
+						prefix: `${operation.target.optionId ? `embeddedForms.${operation.target.optionId}.` : ""}fields.${operation.fieldId}`,
+						survey
+					});
+				}
+				replaceItem(withFormFieldGroupsForTarget(item, groups, operation.target.optionId));
+				break;
+			}
+			case "remove-item": {
+				const removeIds = collectDescendantIds(operation.itemId, new Map(survey.surveyItems.map((item) => [item.id, item])));
+				removeIds.add(operation.itemId);
+				survey.surveyItems = survey.surveyItems.filter((item) => !removeIds.has(item.id)).map((item) => ({
+					...item,
+					config: isRecord$2(item.config) ? {
+						...item.config,
+						items: getGroupChildren(item).filter((id) => !removeIds.has(id))
+					} : item.config
+				}));
+				const translations = new SurveyTranslations(survey.translations);
+				for (const itemId of removeIds) translations.setItemTranslations(itemId, void 0);
+				survey.translations = translations.serialize();
+				break;
+			}
+			case "move-item": {
+				const itemId = operation.itemId;
+				for (const item of survey.surveyItems) {
+					const children = getGroupChildren(item);
+					if (!children.includes(itemId)) continue;
+					replaceItem({
+						...item,
+						config: {
+							...isRecord$2(item.config) ? item.config : {},
+							items: children.filter((id) => id !== itemId)
+						}
+					});
+				}
+				const parent = getItem(operation.target.parentItemId);
+				const children = getGroupChildren(parent);
+				children.splice(operation.target.index ?? children.length, 0, itemId);
+				replaceItem({
+					...parent,
+					config: {
+						...isRecord$2(parent.config) ? parent.config : {},
+						items: children
+					}
+				});
+				break;
+			}
+			case "reorder-items": {
+				const parent = getItem(operation.parentItemId);
+				replaceItem({
+					...parent,
+					config: {
+						...isRecord$2(parent.config) ? parent.config : {},
+						items: operation.itemIds
+					}
+				});
+				break;
+			}
+			case "update-survey-metadata": {
+				const metadata = { ...survey.metadata ?? {} };
+				for (const [key, value] of Object.entries(operation.values)) if (value === null) delete metadata[key];
+				else metadata[key] = value;
+				survey.metadata = Object.keys(metadata).length ? metadata : void 0;
+				break;
+			}
+			case "update-survey-pagination":
+				survey.maxItemsPerPage = operation.value ?? void 0;
+				break;
+			case "update-survey-translation": {
+				const locale = survey.translations?.[operation.locale] ?? {};
+				const surface = { ...locale[operation.surface] ?? {} };
+				surface[operation.contentKey] = buildDraftContent(operation);
+				survey.translations = {
+					...survey.translations ?? {},
+					[operation.locale]: {
+						...locale,
+						[operation.surface]: surface
+					}
+				};
+				break;
+			}
+			case "remove-survey-locale": {
+				const translations = { ...survey.translations ?? {} };
+				delete translations[operation.locale];
+				survey.translations = Object.keys(translations).length ? translations : void 0;
+				break;
+			}
+			case "set-image-asset":
+				survey.assets = {
+					...survey.assets ?? {},
+					[operation.assetId]: operation.asset
+				};
+				break;
+			case "update-image-asset-metadata": {
+				const asset = survey.assets?.[operation.assetId];
+				const metadata = { ...asset.metadata ?? {} };
+				for (const [key, value] of Object.entries(operation.metadata)) if (value === null) delete metadata[key];
+				else if (value !== void 0) Object.assign(metadata, { [key]: value });
+				survey.assets = {
+					...survey.assets ?? {},
+					[operation.assetId]: {
+						...asset,
+						metadata: Object.keys(metadata).length ? metadata : void 0
+					}
+				};
+				break;
+			}
+			case "remove-image-asset": {
+				const assets = { ...survey.assets ?? {} };
+				delete assets[operation.assetId];
+				survey.assets = Object.keys(assets).length ? assets : void 0;
+				break;
+			}
+		}
+	}
+	return rawSurveyDocumentSchema.parse(survey);
+};
+const createSurveyChangeSet = ({ maxOperations, operations, snapshot, summary, turnId }) => {
 	const validation = validateSurveyOperations({
+		maxOperations,
 		operations,
 		snapshot
 	});
@@ -4576,94 +4990,138 @@ const createSurveyChangeSet = ({ operations, snapshot, summary, turnId }) => {
 	};
 };
 //#endregion
-//#region src/engine/turn-change-collector.ts
+//#region src/engine/turn-survey-draft.ts
 const createId = () => globalThis.crypto.randomUUID();
-const SURVEY_CHANGE_CONTINUATION_MODES = ["append", "replace"];
-const SURVEY_CHANGE_CONTINUATION_DESCRIPTION = "Omit only for the first mutation call in this turn. On every later mutation call, use \"append\" for independent additional work or \"replace\" for a correction that should discard all currently active candidates.";
-var TurnChangeCollector = class {
+const operationTargets = (operation) => {
+	switch (operation.kind) {
+		case "create-item": return [`item:${operation.item.id}`];
+		case "update-item-key":
+		case "update-item-label":
+		case "update-item-color":
+		case "update-item-translation":
+		case "update-placed-image":
+		case "patch-item-config":
+		case "add-choice-option":
+		case "update-choice-option-label":
+		case "remove-choice-option":
+		case "reorder-choice-options":
+		case "set-embedded-form":
+		case "remove-embedded-form":
+		case "remove-item":
+		case "move-item": return [`item:${operation.itemId}`];
+		case "upsert-form-field-group":
+		case "remove-form-field-group":
+		case "reorder-form-field-groups":
+		case "upsert-form-field":
+		case "remove-form-field":
+		case "move-form-field": return [`item:${operation.target.itemId}`];
+		case "reorder-items": return [`item:${operation.parentItemId}`];
+		case "set-image-asset":
+		case "update-image-asset-metadata":
+		case "remove-image-asset": return [`asset:${operation.assetId}`];
+		case "update-survey-metadata":
+		case "update-survey-pagination":
+		case "update-survey-translation":
+		case "remove-survey-locale": return ["survey"];
+		case "survey-json-patch": return [];
+	}
+};
+const collectOperationTargets = (operations) => new Set(operations.flatMap(operationTargets));
+/**
+* Request-scoped transactional draft for one assistant response.
+*
+* Mutation tools submit deltas. A successful delta replaces the previous
+* candidate with a newly validated, cumulative change set. A rejected delta
+* leaves the accepted draft intact and blocks authorization until a later
+* delta validates. Only the latest cumulative candidate can be authorized.
+*/
+var TurnSurveyDraft = class {
 	turnId;
 	#candidates = /* @__PURE__ */ new Map();
-	#activeChangeSetIds = [];
-	#blockedChangeSetIds = /* @__PURE__ */ new Set();
-	#ambiguousChangeSetIds = /* @__PURE__ */ new Set();
-	#requiresReplacement = false;
+	#draftOperations = [];
+	#context;
+	#latestChangeSetId;
+	#unresolvedCandidates = /* @__PURE__ */ new Map();
 	#final = null;
 	constructor(turnId = createId()) {
 		this.turnId = turnId;
 	}
-	register(candidate, { continuationMode } = {}) {
-		if (this.#final) throw new Error("Cannot register a survey change after the turn was finalized.");
+	initialize(context) {
+		if (this.#context) throw new Error("The survey turn draft was initialized more than once.");
+		this.#context = context;
+	}
+	stage({ addressedTargets = [], operations, snapshot, summary }) {
+		this.#assertOpen();
+		if (!this.#context && snapshot && "document" in snapshot && "trustedCapabilities" in snapshot) this.#context = snapshot;
+		const currentContext = this.#context ?? snapshot;
+		const targets = new Set([...collectOperationTargets(operations), ...addressedTargets]);
+		const delta = createSurveyChangeSet({
+			operations,
+			snapshot: currentContext,
+			summary,
+			turnId: this.turnId
+		});
+		if (delta.status !== "validated" || !delta.validation.valid) return this.reject(delta, targets);
+		const cumulativeOperations = [...this.#draftOperations, ...delta.operations];
+		if (cumulativeOperations.length > 1e3) return this.reject(createSurveyChangeSet({
+			maxOperations: MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT,
+			operations: cumulativeOperations,
+			snapshot: currentContext,
+			summary,
+			turnId: this.turnId
+		}), targets);
+		if (this.#context) {
+			const survey = applyValidatedSurveyOperationsToDraft({
+				operations: delta.operations,
+				survey: this.#context.survey
+			});
+			this.#context = createSurveyAssistantEngineContext({
+				...this.#context.document,
+				survey
+			}, this.#context.trustedCapabilities);
+		}
+		const registered = surveyChangeSetSchema.parse({
+			...delta,
+			operations: cumulativeOperations,
+			validation: {
+				valid: true,
+				issues: [],
+				warnings: delta.validation.warnings,
+				normalizedOperations: cumulativeOperations
+			},
+			...this.#latestChangeSetId ? { supersedesChangeIds: [this.#latestChangeSetId] } : {}
+		});
+		this.#candidates.set(registered.id, registered);
+		this.#draftOperations = registered.operations;
+		this.#latestChangeSetId = registered.id;
+		for (const [changeSetId, unresolvedTargets] of this.#unresolvedCandidates) if (unresolvedTargets.size === 0 || [...unresolvedTargets].some((target) => targets.has(target))) this.#unresolvedCandidates.delete(changeSetId);
+		return registered;
+	}
+	reject(candidate, addressedTargets = []) {
+		this.#assertOpen();
 		if (this.#candidates.has(candidate.id)) throw new Error(`Survey change "${candidate.id}" was registered more than once.`);
-		const modeRequired = this.#candidates.size > 0 && continuationMode === void 0;
-		const replacementRequired = this.#requiresReplacement && continuationMode !== "replace";
-		const continuationIssue = modeRequired ? {
-			severity: "error",
-			code: "change-mode-required",
-			message: "A prior mutation candidate exists in this turn. Retry this complete proposal with continuationMode \"append\" for independent additional work or \"replace\" for a correction that discards the active candidates."
-		} : replacementRequired ? {
-			severity: "error",
-			code: "change-mode-repair-required",
-			message: "An earlier mutation proposal was rejected and blocked turn authorization. Retry the complete intended proposal with continuationMode \"replace\" before appending any later independent chunks."
-		} : void 0;
-		const candidateWasRejected = candidate.status !== "validated" || !candidate.validation.valid;
-		const ambiguousModeOnly = modeRequired && !candidateWasRejected && continuationIssue?.code === "change-mode-required";
-		const shouldClearActive = continuationMode === "replace" || continuationIssue !== void 0 && !ambiguousModeOnly || candidateWasRejected;
-		const supersedesChangeIds = shouldClearActive ? [...this.#activeChangeSetIds] : [];
-		const recovery = continuationIssue !== void 0 || candidateWasRejected ? ambiguousModeOnly ? {
-			turnAuthorization: "blocked",
-			candidateAuthorization: "not-authorized",
-			requiredAction: "choose-continuation-mode",
-			allowedContinuationModes: ["append", "replace"]
-		} : {
-			turnAuthorization: "blocked",
-			candidateAuthorization: "not-authorized",
-			requiredAction: "resubmit-complete-proposal",
-			allowedContinuationModes: ["replace"],
-			requiredContinuationMode: "replace"
-		} : void 0;
 		const registered = surveyChangeSetSchema.parse({
 			...candidate,
 			turnId: this.turnId,
-			...continuationIssue ? {
-				status: "rejected",
-				validation: {
-					...candidate.validation,
-					valid: false,
-					issues: [...candidate.validation.issues, continuationIssue]
-				}
-			} : {},
-			...supersedesChangeIds.length > 0 ? { supersedesChangeIds } : {},
-			...recovery ? { recovery } : {}
+			status: "rejected",
+			validation: {
+				...candidate.validation,
+				valid: false
+			}
 		});
 		this.#candidates.set(registered.id, registered);
-		const isValidated = registered.status === "validated" && registered.validation.valid;
-		if (shouldClearActive) this.#activeChangeSetIds = [];
-		if (ambiguousModeOnly) {
-			this.#blockedChangeSetIds.add(registered.id);
-			this.#ambiguousChangeSetIds.add(registered.id);
-		} else if (!isValidated) {
-			this.#blockedChangeSetIds.add(registered.id);
-			this.#requiresReplacement = true;
-		} else if (continuationMode === "replace") {
-			this.#blockedChangeSetIds.clear();
-			this.#ambiguousChangeSetIds.clear();
-			this.#requiresReplacement = false;
-		} else if (continuationMode === "append" && this.#ambiguousChangeSetIds.size > 0) {
-			for (const changeSetId of this.#ambiguousChangeSetIds) this.#blockedChangeSetIds.delete(changeSetId);
-			this.#ambiguousChangeSetIds.clear();
-		}
-		if (!this.#requiresReplacement && isValidated) this.#activeChangeSetIds.push(registered.id);
+		this.#unresolvedCandidates.set(registered.id, new Set(addressedTargets));
 		return registered;
 	}
 	finalize(status, createdAt = (/* @__PURE__ */ new Date()).toISOString()) {
 		if (this.#final) return this.#final;
-		const blockedChangeSetIds = [...this.#blockedChangeSetIds];
-		const canAuthorize = status === "completed" && !this.#requiresReplacement && blockedChangeSetIds.length === 0;
+		const blockedChangeSetIds = [...this.#unresolvedCandidates.keys()];
+		const canAuthorize = status === "completed" && blockedChangeSetIds.length === 0 && this.#latestChangeSetId !== void 0;
 		this.#final = surveyAssistantTurnFinalSchema.parse({
 			protocolVersion: 1,
 			turnId: this.turnId,
 			status,
-			executableChangeSetIds: canAuthorize ? this.#activeChangeSetIds : [],
+			executableChangeSetIds: canAuthorize ? [this.#latestChangeSetId] : [],
 			...blockedChangeSetIds.length > 0 ? { blockedChangeSetIds } : {},
 			createdAt
 		});
@@ -4672,9 +5130,18 @@ var TurnChangeCollector = class {
 	getCandidate(changeSetId) {
 		return this.#candidates.get(changeSetId);
 	}
+	get draftOperations() {
+		return this.#draftOperations;
+	}
+	get context() {
+		return this.#context;
+	}
 	get final() {
 		return this.#final;
 	}
+	#assertOpen() {
+		if (this.#final) throw new Error("Cannot register a survey change after the turn was finalized.");
+	}
 };
 //#endregion
 //#region src/engine/task-context.ts
@@ -5194,6 +5661,6 @@ const auditSurvey = (context, options = {}) => {
 	};
 };
 //#endregion
-export { deriveResponseSlotTypes as $, getRawSurvey$1 as A, resolveItemSummary as B, clampLimit as C, formFieldGroupLayoutSchema as D, formFieldGroupDetailsSchema as E, mapKeyIndexById as F, summarizeKeyIndexEntry as G, summarizeFocusItemNode as H, mapOutlineById as I, translationEntrySchema as J, summarizeOutlineNode as K, mapRawItemsById as L, itemConfigDetailsSchema as M, itemMatchesQuery as N, formSelectOptionDetailsSchema as O, itemSummarySchema as P, createSurveyAssistantEngineContext as Q, normalizeText as R, choiceOptionDetailsSchema as S, formFieldDetailsSchema as T, summarizeItemById as U, sliceWithCursor as V, summarizeKeyIndexEntries as W, inferExpressionReturnType as X, unique as Y, validateExpression as Z, buildConfigSearchText as _, SURVEY_CHANGE_CONTINUATION_MODES as a, buildItemTranslationEntries as b, buildSurveyDocumentVersion as c, normalizeSurveyChangeOperations as d, buildExpressionMutationPatches as f, MAX_LIMIT as g, DEFAULT_LIMIT as h, SURVEY_CHANGE_CONTINUATION_DESCRIPTION as i, getRawSurveyItems as j, getKeyIndexEntries as k, createSurveyChangeSet as l, expressionSchema as m, SurveyAssistantTaskResultCache as n, TurnChangeCollector as o, expressionMutationSchema as p, summarizeRawItem as q, buildSurveyAssistantTaskContext as r, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as s, auditSurvey as t, validateSurveyOperations as u, buildEmbeddedFormDetails as v, findDirectChildrenByFullKey as w, buildSurveyTranslations as x, buildItemConfigDetails as y, parseCursor as z };
+export { deriveResponseSlotTypes as $, getRawSurvey$1 as A, resolveItemSummary as B, clampLimit as C, formFieldGroupLayoutSchema as D, formFieldGroupDetailsSchema as E, mapKeyIndexById as F, summarizeKeyIndexEntry as G, summarizeFocusItemNode as H, mapOutlineById as I, translationEntrySchema as J, summarizeOutlineNode as K, mapRawItemsById as L, itemConfigDetailsSchema as M, itemMatchesQuery as N, formSelectOptionDetailsSchema as O, itemSummarySchema as P, createSurveyAssistantEngineContext as Q, normalizeText as R, choiceOptionDetailsSchema as S, formFieldDetailsSchema as T, summarizeItemById as U, sliceWithCursor as V, summarizeKeyIndexEntries as W, inferExpressionReturnType as X, unique as Y, validateExpression as Z, buildConfigSearchText as _, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as a, buildItemTranslationEntries as b, buildSurveyDocumentVersion as c, normalizeSurveyChangeOperations as d, buildExpressionMutationPatches as f, MAX_LIMIT as g, DEFAULT_LIMIT as h, TurnSurveyDraft as i, getRawSurveyItems as j, getKeyIndexEntries as k, createSurveyChangeSet as l, expressionSchema as m, SurveyAssistantTaskResultCache as n, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT as o, expressionMutationSchema as p, summarizeRawItem as q, buildSurveyAssistantTaskContext as r, applyValidatedSurveyOperationsToDraft as s, auditSurvey as t, validateSurveyOperations as u, buildEmbeddedFormDetails as v, findDirectChildrenByFullKey as w, buildSurveyTranslations as x, buildItemConfigDetails as y, parseCursor as z };
 
-//# sourceMappingURL=engine-DQrCO_ur.mjs.map
+//# sourceMappingURL=engine-0AJrv0hI.mjs.map