@case-framework/survey-assistant 0.6.0 → 0.8.0

package/dist/{protocol-DJUP4gc0.mjs → protocol-CF4Bh_Ch.mjs}

@@ -1,5 +1,35 @@
 import { z } from "zod";
 import { SURVEY_EDITOR_ITEM_COLORS } from "@case-framework/survey-core/editor/colors";
+//#region src/protocol/sanitization.ts
+const MAX_USER_ERROR_MESSAGE_LENGTH = 700;
+const CONTROL_CHARACTERS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/g;
+const DATA_URL = /data:[^;,\s]+;base64,[a-z0-9+/=_-]+/gi;
+const BEARER_TOKEN = /\bbearer\s+[a-z0-9._~+/-]{8,}/gi;
+const OPENAI_KEY = /\bsk-(?:proj-)?[a-z0-9_-]{8,}/gi;
+const AUTHORIZATION_VALUE = /(authorization\s*[:=]\s*)[^\s,;]+/gi;
+const API_KEY_VALUE = /((?:api[-_ ]?key|token|secret)\s*[:=]\s*)[^\s,;]+/gi;
+const redactSurveyAssistantDiagnosticSecrets = (value) => value.replace(CONTROL_CHARACTERS, "").replace(DATA_URL, "[data URL omitted]").replace(BEARER_TOKEN, "Bearer [credential omitted]").replace(OPENAI_KEY, "[credential omitted]").replace(AUTHORIZATION_VALUE, "$1[credential omitted]").replace(API_KEY_VALUE, "$1[credential omitted]");
+const sanitizeSurveyAssistantDiagnosticText = (value, maximum = 700) => {
+	const normalized = redactSurveyAssistantDiagnosticSecrets(value).replace(/\s+/g, " ").trim();
+	if (normalized.length <= maximum) return normalized;
+	return `${normalized.slice(0, Math.max(0, maximum - 1))}…`;
+};
+const isSurveyAssistantSensitiveMetadataKey = (key) => {
+	const normalized = key.toLocaleLowerCase();
+	return normalized.includes("authorization") || normalized.includes("credential") || normalized.includes("encrypted") || normalized.includes("password") || normalized.includes("redacted") || normalized.includes("secret") || normalized.includes("signature") || normalized === "token" || normalized.endsWith("token") || normalized.includes("api_key") || normalized.includes("apikey");
+};
+const getSurveyAssistantEmbeddedBinaryMarker = (value, parent, key) => {
+	if (typeof value !== "string") return void 0;
+	if (key === "data" && parent?.type === "embedded" && parent.encoding === "base64") return {
+		characters: value.length,
+		redacted: "base64"
+	};
+	if (value.length > 512 && /^data:[^;,]+;base64,/.test(value)) return {
+		characters: value.length,
+		redacted: "data-url"
+	};
+};
+//#endregion
 //#region src/protocol/errors.ts
 const surveyAssistantErrorCodeSchema = z.enum([
 	"attachment_unavailable",
@@ -11,16 +41,30 @@ const surveyAssistantErrorCodeSchema = z.enum([
 const surveyAssistantErrorInfoSchema = z.object({
 	code: surveyAssistantErrorCodeSchema,
 	detail: z.string().optional(),
-	retryable: z.boolean().optional()
-});
+	retryable: z.boolean().optional(),
+	upstreamStatus: z.number().int().min(100).max(599).optional(),
+	providerRequestId: z.string().trim().min(1).max(240).optional(),
+	providerMessage: z.string().max(700).optional()
+});
+const isSurveyAssistantErrorRetryable = (error, httpStatus) => {
+	if (error.retryable !== void 0) return error.retryable;
+	if (error.code === "rate_limited") return true;
+	const status = httpStatus ?? error.upstreamStatus;
+	if (error.code === "request_failed") return status === void 0 || status >= 500;
+	return error.code === "attachment_unavailable" && status !== void 0 && status >= 500;
+};
 const ERROR_PREFIX = "case-survey-assistant-error:";
 const serializeSurveyAssistantError = (error) => `${ERROR_PREFIX}${JSON.stringify(surveyAssistantErrorInfoSchema.parse(error))}`;
 const parseSurveyAssistantError = (value) => {
 	if (typeof value === "object" && value !== null && "code" in value) {
+		const detail = "detail" in value && typeof value.detail === "string" ? value.detail : "message" in value && typeof value.message === "string" ? value.message : void 0;
 		const parsed = surveyAssistantErrorInfoSchema.safeParse({
 			code: value.code,
-			detail: "detail" in value && typeof value.detail === "string" ? value.detail : "message" in value && typeof value.message === "string" ? value.message : void 0,
-			retryable: "retryable" in value && typeof value.retryable === "boolean" ? value.retryable : void 0
+			detail: detail ? sanitizeSurveyAssistantDiagnosticText(detail, 700) : void 0,
+			retryable: "retryable" in value && typeof value.retryable === "boolean" ? value.retryable : void 0,
+			upstreamStatus: "upstreamStatus" in value && typeof value.upstreamStatus === "number" ? value.upstreamStatus : void 0,
+			providerRequestId: "providerRequestId" in value && typeof value.providerRequestId === "string" ? sanitizeSurveyAssistantDiagnosticText(value.providerRequestId, 240) : void 0,
+			providerMessage: "providerMessage" in value && typeof value.providerMessage === "string" ? sanitizeSurveyAssistantDiagnosticText(value.providerMessage, 700) : void 0
 		});
 		if (parsed.success) return parsed.data;
 	}
@@ -31,10 +75,65 @@ const parseSurveyAssistantError = (value) => {
 	} catch {}
 	return {
 		code: "request_failed",
-		...message.trim() ? { detail: message.trim() } : {}
+		...message.trim() ? { detail: sanitizeSurveyAssistantDiagnosticText(message, 700) } : {}
 	};
 };
 //#endregion
+//#region src/protocol/response-settings.ts
+const variableName = z.string().regex(/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/).max(32);
+const responseNamingEditSchema = z.union([z.object({
+	slotId: z.string().min(1),
+	variableName
+}).strict(), z.object({
+	primitiveId: z.string().min(1),
+	prefix: variableName.optional(),
+	rows: z.record(z.string(), variableName).optional(),
+	columns: z.record(z.string(), variableName).optional()
+}).strict()]);
+const responseExportSettingsSchema = z.object({
+	mode: z.string().min(1),
+	include: z.boolean().optional(),
+	categorical: z.enum([
+		"codes",
+		"labels",
+		"ids"
+	]).optional(),
+	multiple: z.enum([
+		"json",
+		"delimited",
+		"indicators"
+	]).optional(),
+	delimiter: z.string().optional(),
+	locale: z.string().optional(),
+	optionCodes: z.record(z.string(), z.string()).optional(),
+	optionLabels: z.record(z.string(), z.string()).optional(),
+	booleanValues: z.object({
+		true: z.string(),
+		false: z.string()
+	}).optional(),
+	precision: z.number().int().nonnegative().optional(),
+	durationUnit: z.enum([
+		"seconds",
+		"minutes",
+		"hours",
+		"days",
+		"weeks",
+		"months",
+		"years"
+	]).optional(),
+	dateFormat: z.object({ pattern: z.string().min(1) }).optional(),
+	maskChar: z.string().optional()
+}).strict();
+const responseSettingsEditSchema = z.object({
+	slotId: z.string().min(1),
+	optionCodes: z.record(z.string(), z.string().min(1)).optional(),
+	exportSettings: responseExportSettingsSchema.optional()
+}).strict();
+const responseSettingsChangesSchema = z.object({
+	naming: z.array(responseNamingEditSchema).max(200),
+	settings: z.array(responseSettingsEditSchema).max(200)
+});
+//#endregion
 //#region src/protocol/content.ts
 const jsonValueSchema = z.lazy(() => z.union([
 	z.string(),
@@ -202,22 +301,20 @@ const surveyContentSchema = z.discriminatedUnion("type", [
 //#endregion
 //#region src/protocol/operations.ts
 const operationIdSchema = z.string().min(1).max(120).optional().describe("Optional client/model supplied id for correlating validation issues.");
-const itemIdentifierSchema = z.string().min(1).max(240).describe("Survey item id, key, or fullKey.");
-const itemKeySchema = z.string().min(1).max(120).describe("New item key. It must be unique among siblings.");
+const itemIdentifierSchema = z.string().min(1).max(240).describe("Exact stable survey item ID. Inspect editor names and breadcrumbs to discover the ID.");
 const itemTranslationSchema = z.object({
 	locale: z.string().min(1).max(40),
 	contentKey: z.string().min(1).max(240).describe("Item translation content key, for example \"label\" or \"content\"."),
 	plainText: z.string().max(2e4).optional().describe("Simple text content to persist for the translation key."),
-	content: surveyContentSchema.optional().describe("Structured survey content to persist for the translation key. Use { \"type\": \"richText\", \"version\": 1, \"doc\": ... } for formatted text.")
-}).refine((translation) => translation.plainText !== void 0 || translation.content !== void 0, { message: "Provide either plainText or content for a translation." });
+	content: surveyContentSchema.optional().describe("Canonical structured survey content to persist for the translation key. Use { \"type\": \"richText\", \"version\": 1, \"doc\": ... } for formatted text. The survey_change model interface also accepts documented richTextBlocks shorthand at this translation level and normalizes it to this field before canonical validation.")
+}).refine((translation) => translation.plainText !== void 0 !== (translation.content !== void 0), { message: "Provide exactly one of plainText or content for a translation." });
 const choiceOptionInputSchema = z.object({
 	id: z.string().min(1).max(120).optional().describe("Optional stable option id. If omitted, the validator derives a unique id."),
-	key: z.string().min(1).max(120).optional().describe("Optional coding key. If omitted, the validator derives a unique key."),
+	code: z.string().min(1).max(120).optional().describe("Optional export code. If omitted, the validator derives a unique code."),
 	label: z.string().min(1).max(1e3).describe("Respondent-visible option label as a plain string. Do not pass a translation object here; add-choice-option creates the matching translation in its locale.")
 });
 const rawSurveyItemForCreateSchema = z.object({
 	id: z.string().min(1).max(120).optional(),
-	key: itemKeySchema,
 	itemType: z.string().min(1).max(120),
 	metadata: z.record(z.string(), z.string()).optional(),
 	config: z.unknown().optional().describe("Optional item-type config. For choiceItem, provide response options as config.options, for example [{ \"label\": \"Fuji\" }, { \"label\": \"Gala\" }]. Use config.maxSelection: 1 for single choice, null for unlimited multiple choice / select-all-that-apply, or a number greater than 1 for capped multiple choice. Put an inline embeddedForm directly on a new choice option; default an eligible one-field embeddedForm to authoringMode \"simple\" and use \"custom\" for blank or structured follow-ups. For formItem, use authoringMode \"simple\" only with one field group containing one field; use \"custom\" for blank or multi-field forms. The validator converts option labels into options.<optionId>.label translations."),
@@ -226,7 +323,7 @@ const rawSurveyItemForCreateSchema = z.object({
 	disabledConditions: z.any().optional(),
 	prefills: z.array(z.any()).optional()
 }).passthrough();
-const jsonPointerPathSchema = z.string().max(500).describe("JSON Pointer path into the survey document, for example \"/surveyItems/1/config/options/0/key\" or \"/translations/en/itemTranslations/<itemId>/title\".");
+const jsonPointerPathSchema = z.string().max(500).describe("Survey-root JSON Pointer obtained from current raw inspection. Escape \"~\" as \"~0\" and \"/\" within one path segment as \"~1\". Use \"/-\" only as the final destination segment of an add, move, or copy that appends to an array.");
 const jsonPatchOperationSchema = z.discriminatedUnion("op", [
 	z.object({
 		op: z.literal("add"),
@@ -262,17 +359,12 @@ const createItemOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("create-item"),
 	target: z.object({
-		parentItemId: z.string().max(240).describe("Parent group item id, key, or fullKey where the new item should be inserted. Use the root group id/key for top-level items."),
-		index: z.number().int().min(0).optional()
+		parentItemId: z.string().max(240).describe("Exact parent group item ID. Use the inspected root group ID for top-level items."),
+		index: z.number().int().min(0).optional().describe("Zero-based insertion index in the parent group. Omit to append; use 0 to insert first.")
 	}),
 	item: rawSurveyItemForCreateSchema,
-	translations: z.array(itemTranslationSchema).optional().describe("Operation-level item translations for visible content, for example [{ \"locale\": \"en\", \"contentKey\": \"title\", \"plainText\": \"Question text\" }]. Put this property inside the create-item operation beside target and item, never beside the survey_change operations array. For formatted content, use the \"content\" field with a richText object. Form select/dropdown option labels must be translations at fields.<fieldId>.options.<optionId>.label.")
-});
-const updateItemKeyOperationSchema = z.object({
-	id: operationIdSchema,
-	kind: z.literal("update-item-key"),
-	itemId: itemIdentifierSchema,
-	key: itemKeySchema
+	presetId: z.string().min(1).max(120).optional().describe("Server-supported toolbox preset ID declared by the item capability. Materializes its configuration and translations; explicit item.config fields override defaults. Supply the remaining required content specified by the capability."),
+	translations: z.array(itemTranslationSchema).optional().describe("Operation-level item translations for visible content, for example [{ \"locale\": \"en\", \"contentKey\": \"title\", \"plainText\": \"Question text\" }]. Put this property inside the create-item operation beside target and item, never beside the survey_change operations array. For formatted content, the model interface accepts documented richTextBlocks shorthand and normalizes it to canonical content before validation. Form select/dropdown option labels must be translations at fields.<fieldId>.options.<optionId>.label.")
 });
 const updateItemLabelOperationSchema = z.object({
 	id: operationIdSchema,
@@ -293,8 +385,8 @@ const updateItemTranslationOperationSchema = z.object({
 	locale: z.string().min(1).max(40),
 	contentKey: z.string().min(1).max(240).describe("Item translation content key, for example \"label\"."),
 	plainText: z.string().max(2e4).optional().describe("Simple text content to persist for the translation key."),
-	content: surveyContentSchema.optional().describe("Structured survey content to persist for the translation key. Use { \"type\": \"richText\", \"version\": 1, \"doc\": ... } for formatted text.")
-}).refine((operation) => operation.plainText !== void 0 || operation.content !== void 0, { message: "Provide either plainText or content for update-item-translation." });
+	content: surveyContentSchema.optional().describe("Canonical structured survey content to persist for the translation key. Use { \"type\": \"richText\", \"version\": 1, \"doc\": ... } for formatted text. The survey_change model interface also accepts documented top-level richTextBlocks shorthand and normalizes it to this field before canonical validation.")
+}).refine((operation) => operation.plainText !== void 0 !== (operation.content !== void 0), { message: "Provide exactly one of plainText or content for update-item-translation." });
 const placedImageDimensionSchema = z.union([z.object({
 	unit: z.literal("px"),
 	value: z.number().finite().nonnegative()
@@ -336,6 +428,7 @@ const patchItemConfigOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("patch-item-config"),
 	itemId: itemIdentifierSchema,
+	translations: z.array(itemTranslationSchema).max(200).optional().describe("Translations belonging to this configuration edit, applied atomically with it. Use the content keys declared by the item capability."),
 	patches: z.array(jsonPatchOperationSchema).min(1).max(100).describe("JSON Patch operations relative to this item's config root, for example [{ \"op\": \"replace\", \"path\": \"/max\", \"value\": 7 }]. Inspect the item first and do not include /surveyItems/<index>/config in these paths.")
 });
 const formTargetSchema = z.object({
@@ -345,7 +438,7 @@ const formTargetSchema = z.object({
 const formTranslationsSchema = z.array(itemTranslationSchema).max(100).optional().describe("Translations written atomically with this form structure change. Put this property inside the form operation object, never beside the survey_change operations array. Content keys are relative to the form; embedded-form prefixes are added automatically.");
 const formFieldInputSchema = z.object({
 	id: z.string().min(1).max(120),
-	key: z.string().min(1).max(120),
+	variableName: z.string().min(1).max(32),
 	type: z.enum([
 		"input",
 		"textarea",
@@ -444,7 +537,7 @@ const updateChoiceOptionLabelOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("update-choice-option-label"),
 	itemId: itemIdentifierSchema,
-	optionId: z.string().min(1).max(240).describe("Existing choice option id, key, or current visible label."),
+	optionId: z.string().min(1).max(240).describe("Exact persistent choice option ID; discover it through inspection."),
 	locale: z.string().min(1).max(40).optional(),
 	label: z.string().min(1).max(1e3).describe("New respondent-visible option label.")
 });
@@ -452,13 +545,13 @@ const removeChoiceOptionOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("remove-choice-option"),
 	itemId: itemIdentifierSchema,
-	optionId: z.string().min(1).max(240).describe("Existing choice option id, key, or current visible label.")
+	optionId: z.string().min(1).max(240).describe("Exact persistent choice option ID; discover it through inspection.")
 });
 const reorderChoiceOptionsOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("reorder-choice-options"),
 	itemId: itemIdentifierSchema,
-	optionIds: z.array(z.string().min(1).max(240)).min(1).max(100).describe("Complete desired order of existing choice options. Entries can be option ids, keys, or current visible labels.")
+	optionIds: z.array(z.string().min(1).max(240)).min(1).max(100).describe("Complete desired order of existing choice options, using their exact persistent option IDs.")
 });
 const removeItemOperationSchema = z.object({
 	id: operationIdSchema,
@@ -472,7 +565,7 @@ const moveItemOperationSchema = z.object({
 	itemId: itemIdentifierSchema,
 	target: z.object({
 		parentItemId: itemIdentifierSchema,
-		index: z.number().int().min(0).optional()
+		index: z.number().int().min(0).optional().describe("Zero-based insertion index in the parent group. Omit to append; use 0 to insert first.")
 	}).describe("A different parent group and optional insertion index. Omit unchanged placements; use reorder-items for sibling order within the current parent.")
 });
 const reorderItemsOperationSchema = z.object({
@@ -505,8 +598,8 @@ const updateSurveyTranslationOperationSchema = z.object({
 	]),
 	contentKey: z.string().min(1).max(240),
 	plainText: z.string().max(2e4).optional(),
-	content: surveyContentSchema.optional()
-}).refine((operation) => operation.plainText !== void 0 || operation.content !== void 0, { message: "Provide either plainText or content for update-survey-translation." });
+	content: surveyContentSchema.optional().describe("Canonical structured survey content to persist for the survey translation. The survey_change model interface also accepts documented top-level richTextBlocks shorthand and normalizes it to this field before canonical validation.")
+}).refine((operation) => operation.plainText !== void 0 !== (operation.content !== void 0), { message: "Provide exactly one of plainText or content for update-survey-translation." });
 const surveyLocaleSchema = z.string().trim().min(1).max(40);
 const addSurveyLocaleOperationSchema = z.object({
 	id: operationIdSchema,
@@ -561,12 +654,15 @@ const removeImageAssetOperationSchema = z.object({
 const surveyPatchOperationSchema = z.object({
 	id: operationIdSchema,
 	kind: z.literal("survey-json-patch"),
-	patches: z.array(jsonPatchOperationSchema).min(1).max(100).describe("Batch of JSON Patch operations applied to the survey document. Use this for raw survey edits such as reordering group items, editing item config, survey metadata, template values, translations/locales, or maxItemsPerPage.")
+	patches: z.array(jsonPatchOperationSchema).min(1).max(100).describe("Sequential JSON Patch operations applied to the survey document. Use only for an existing, inspected survey-root extension with no typed operation, patch-item-config helper, or survey_expression mutation. Parent paths must exist. Add creates or replaces an object member, inserts at an array index, or appends with /-. Replace, remove, and test require an existing path. Move and copy require an existing from path. Preserve exact JSON value types, and guard overwrites or removals with test when the current value is known.")
 });
 const asDiscriminable = (schema) => schema;
 const surveyOperationSchemasByKind = {
 	"create-item": createItemOperationSchema,
-	"update-item-key": updateItemKeyOperationSchema,
+	"update-response-settings": responseSettingsChangesSchema.extend({
+		id: operationIdSchema,
+		kind: z.literal("update-response-settings")
+	}),
 	"update-item-label": updateItemLabelOperationSchema,
 	"update-item-color": updateItemColorOperationSchema,
 	"update-item-translation": updateItemTranslationOperationSchema,
@@ -616,7 +712,6 @@ const surveyValidationResultSchema = z.object({
 const SURVEY_OPERATION_KINDS = Object.freeze(Object.keys(surveyOperationSchemasByKind));
 const surveyJsonPatchOperationSchema = jsonPatchOperationSchema;
 const surveyAssistantCreateItemOperationSchema = createItemOperationSchema;
-const surveyAssistantUpdateItemKeyOperationSchema = updateItemKeyOperationSchema;
 const surveyAssistantUpdateItemLabelOperationSchema = updateItemLabelOperationSchema;
 const surveyAssistantUpdateItemColorOperationSchema = updateItemColorOperationSchema;
 const surveyAssistantUpdateItemTranslationOperationSchema = updateItemTranslationOperationSchema;
@@ -693,9 +788,11 @@ const surveyEditorUIContextSchema = z.object({
 		"item-editor",
 		"preview-mode",
 		"translation-mode",
-		"asset-manager"
+		"asset-manager",
+		"response-data"
 	]),
 	selectedItemId: z.string().optional(),
+	responseSlotId: z.string().optional(),
 	selectedLocale: z.string().min(1),
 	focusItemId: z.string().optional(),
 	recentItemIds: z.array(z.string()).max(10).optional(),
@@ -729,12 +826,12 @@ const surveyEditorUIContextSchema = z.object({
 });
 const rawSurveyItemSchema = z.object({
 	id: z.string().min(1),
-	key: z.string().min(1),
 	itemType: z.string().min(1)
 }).passthrough();
 const rawSurveyTranslationsSchema = z.record(z.string(), z.object({ itemTranslations: z.record(z.string(), z.record(z.string(), surveyContentSchema)).optional() }).passthrough());
 const rawSurveyDocumentSchema = z.object({
 	$schema: z.string().min(1),
+	schemaVersion: z.literal(2),
 	surveyItems: z.array(rawSurveyItemSchema).min(1),
 	translations: rawSurveyTranslationsSchema.optional()
 }).passthrough();
@@ -790,14 +887,15 @@ const surveyAssistantKeySuggestionSchema = surveyAssistantSuggestedTextSchema.ex
 	category: surveyAssistantKeySuggestionCategorySchema,
 	rationale: z.string().optional()
 });
-const surveyAssistantSuggestItemKeyInputSchema = z.object({
+const surveyAssistantSuggestResponseNameInputSchema = z.object({
 	itemId: z.string().min(1),
-	draftKey: z.string(),
-	currentKey: z.string(),
-	siblingKeys: z.array(z.string()),
+	slotId: z.string().min(1),
+	draftName: z.string(),
+	currentName: z.string(),
+	existingNames: z.array(z.string()),
 	maxSuggestions: z.number().int().positive().optional()
 });
-const surveyAssistantSuggestItemKeyResultSchema = z.object({ suggestions: z.array(surveyAssistantKeySuggestionSchema) });
+const surveyAssistantSuggestResponseNameResultSchema = z.object({ suggestions: z.array(surveyAssistantKeySuggestionSchema) });
 const surveyAssistantSuggestItemLabelInputSchema = z.object({
 	itemId: z.string().min(1),
 	draftLabel: z.string(),
@@ -819,8 +917,8 @@ const surveyAssistantTranslateContentInputSchema = z.object({
 const surveyAssistantTranslateContentResultSchema = z.object({ translations: z.record(z.string(), z.record(z.string(), z.string())) });
 const surveyAssistantTaskItemSummarySchema = z.object({
 	id: z.string().min(1),
-	key: z.string(),
-	fullKey: z.string(),
+	editorName: z.string(),
+	breadcrumb: z.string(),
 	itemType: z.string().min(1),
 	itemLabel: z.string().optional(),
 	visibleText: z.array(z.object({
@@ -830,6 +928,11 @@ const surveyAssistantTaskItemSummarySchema = z.object({
 	})),
 	visibleTextTruncated: z.boolean()
 });
+const surveyAssistantSuggestResponseSettingsInputSchema = z.object({
+	slotIds: z.array(z.string().min(1)).min(1).max(200),
+	category: surveyAssistantKeySuggestionCategorySchema.default("fair")
+});
+const surveyAssistantSuggestResponseSettingsResultSchema = responseSettingsChangesSchema;
 const namingRelationshipSchema = z.enum([
 	"sibling",
 	"same-type",
@@ -847,11 +950,14 @@ const surveyAssistantTaskContextSchema = z.object({
 		itemCount: z.number().int().nonnegative(),
 		selectedLocale: z.string().min(1)
 	}),
+	responseVariables: z.array(z.record(z.string(), z.unknown())).optional(),
+	existingVariableNames: z.array(z.string()).optional(),
+	responseOwners: z.array(z.record(z.string(), z.unknown())).optional(),
 	focus: z.object({
 		item: surveyAssistantTaskItemSummarySchema,
 		parent: surveyAssistantTaskItemSummarySchema.optional(),
 		ancestorPath: z.array(surveyAssistantTaskItemSummarySchema),
-		siblingKeys: z.array(z.string()),
+		siblingNames: z.array(z.string()),
 		siblingItems: z.array(surveyAssistantTaskItemSummarySchema),
 		siblingItemCount: z.number().int().nonnegative(),
 		siblingItemsTruncated: z.boolean(),
@@ -898,8 +1004,13 @@ const taskRequestBase = {
 const surveyAssistantTaskRequestSchema = z.discriminatedUnion("taskId", [
 	z.object({
 		...taskRequestBase,
-		taskId: z.literal("suggest-item-key"),
-		input: surveyAssistantSuggestItemKeyInputSchema
+		taskId: z.literal("suggest-response-settings"),
+		input: surveyAssistantSuggestResponseSettingsInputSchema
+	}),
+	z.object({
+		...taskRequestBase,
+		taskId: z.literal("suggest-response-name"),
+		input: surveyAssistantSuggestResponseNameInputSchema
 	}),
 	z.object({
 		...taskRequestBase,
@@ -957,6 +1068,12 @@ const surveyChangeSetSchema = z.object({
 	summary: z.string().min(1).max(500),
 	operations: z.array(surveyOperationSchema),
 	supersedesChangeIds: z.array(z.string().min(1)).max(100).optional(),
+	pendingRepairs: z.array(z.object({
+		changeId: z.string().min(1),
+		targets: z.array(z.string()),
+		requiresExplicitRetry: z.boolean(),
+		allowsAcknowledgment: z.boolean().optional()
+	})).optional(),
 	precondition: surveyDocumentVersionSchema.optional(),
 	postChange: z.object({
 		version: surveyDocumentVersionSchema,
@@ -970,9 +1087,23 @@ const surveyChangeSetSchema = z.object({
 		touchedItems: z.array(z.object({
 			itemId: z.string().min(1),
 			itemType: z.string().min(1),
-			key: z.string().min(1),
-			fullKey: z.string().min(1),
+			editorName: z.string().min(1),
+			breadcrumb: z.string().min(1),
 			itemLabel: z.string().optional(),
+			placement: z.object({
+				parentItemId: z.string().min(1),
+				index: z.number().int().nonnegative(),
+				siblingCount: z.number().int().nonnegative(),
+				previousItemId: z.string().min(1).optional(),
+				nextItemId: z.string().min(1).optional(),
+				shuffled: z.boolean()
+			}).optional(),
+			childOrder: z.object({
+				itemIds: z.array(z.string().min(1)).max(16),
+				total: z.number().int().nonnegative(),
+				truncated: z.boolean(),
+				shuffled: z.boolean()
+			}).optional(),
 			translationCount: z.number().int().nonnegative(),
 			translations: z.array(z.object({
 				locale: z.string().min(1),
@@ -982,7 +1113,8 @@ const surveyChangeSetSchema = z.object({
 				truncated: z.boolean()
 			})).max(12),
 			responseSlotCount: z.number().int().nonnegative(),
-			responseSlots: z.array(z.string().min(1)).max(12)
+			responseSlots: z.array(z.string().min(1)).max(12),
+			responseVariables: z.array(z.unknown()).max(12).optional()
 		})).max(6),
 		truncated: z.boolean()
 	}).optional(),
@@ -1118,6 +1250,6 @@ const applyReceiptSchema = z.object({
 });
 const surveyAssistantDraftChangeEventSchema = surveyChangeSetSchema;
 //#endregion
-export { jsonPatchOperationSchema as $, createSurveyAssistantThreadInputSchema as A, surveyContentSchema as At, surveyAssistantSnapshotSchema as B, surveyAssistantTaskInvocationModeSchema as C, surveyValidationResultSchema as Ct, surveyAssistantTranslateContentInputSchema as D, updateItemLabelOperationSchema as Dt, surveyAssistantTranslateContentEntrySchema as E, updateItemKeyOperationSchema as Et, SURVEY_ASSISTANT_PROTOCOL_VERSION as F, assistantItemAuthoringSchema as G, surveyDocumentVersionSchema as H, rawSurveyDocumentSchema as I, assistantResponseSlotSchema as J, assistantItemCreateModeSchema as K, surveyAssistantDraftChangePreconditionSchema as L, surveyAssistantThreadSchema as M, serializeSurveyAssistantError as Mt, surveyAssistantThreadTranscriptSchema as N, surveyAssistantErrorCodeSchema as Nt, surveyAssistantTranslateContentResultSchema as O, updateItemTranslationOperationSchema as Ot, updateSurveyAssistantThreadInputSchema as P, surveyAssistantErrorInfoSchema as Pt, createItemOperationSchema as Q, surveyAssistantProtocolVersionSchema as R, surveyAssistantTaskContextSchema as S, surveyValidationIssueSchema as St, surveyAssistantTaskRequestSchema as T, updateItemColorOperationSchema as Tt, surveyEditorUIContextSchema as U, surveyDocumentSnapshotSchema as V, assistantContentSurfaceSchema as W, SURVEY_OPERATION_KINDS as X, surveyAssistantCapabilityManifestSchema as Y, addChoiceOptionOperationSchema as Z, surveyAssistantSuggestItemKeyInputSchema as _, surveyAssistantValidationResultSchema as _t, surveyApplyStatusSchema as a, surveyAssistantCreateItemOperationSchema as at, surveyAssistantSuggestItemLabelResultSchema as b, surveyOperationSchemasByKind as bt, surveyAssistantDraftChangeEventSchema as c, surveyAssistantRemoveItemOperationSchema as ct, surveyBatchApplyResultSchema as d, surveyAssistantUpdateChoiceOptionLabelOperationSchema as dt, patchItemConfigOperationSchema as et, surveyChangeSetSchema as f, surveyAssistantUpdateItemColorOperationSchema as ft, surveyAssistantKeySuggestionSchema as g, surveyAssistantValidationIssueSchema as gt, surveyAssistantKeySuggestionCategorySchema as h, surveyAssistantUpdateItemTranslationOperationSchema as ht, surveyApplyResultSchema as i, surveyAssistantAddChoiceOptionOperationSchema as it, surveyAssistantThreadListSchema as j, parseSurveyAssistantError as jt, SURVEY_ASSISTANT_ATTACHMENT_PART_TYPE as k, jsonValueSchema as kt, surveyAssistantTurnFinalSchema as l, surveyAssistantReorderChoiceOptionsOperationSchema as lt, surveyAssistantModelOptionSchema as m, surveyAssistantUpdateItemLabelOperationSchema as mt, SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE as n, removeItemOperationSchema as nt, surveyAssistantApplyOutcomeSchema as o, surveyAssistantOperationSchema as ot, surveyAssistantModelCatalogSchema as p, surveyAssistantUpdateItemKeyOperationSchema as pt, assistantItemTypeManifestSchema as q, applyReceiptSchema as r, reorderChoiceOptionsOperationSchema as rt, surveyAssistantApplyPolicySchema as s, surveyAssistantRemoveChoiceOptionOperationSchema as st, SURVEY_ASSISTANT_TURN_FINAL_DATA_NAME as t, removeChoiceOptionOperationSchema as tt, surveyAssistantTurnTerminationReasonSchema as u, surveyAssistantSurveyJsonPatchOperationSchema as ut, surveyAssistantSuggestItemKeyResultSchema as v, surveyJsonPatchOperationSchema as vt, surveyAssistantTaskItemSummarySchema as w, updateChoiceOptionLabelOperationSchema as wt, surveyAssistantSuggestedTextSchema as x, surveyPatchOperationSchema as xt, surveyAssistantSuggestItemLabelInputSchema as y, surveyOperationSchema as yt, surveyAssistantSnapshotPayloadSchema as z };
+export { addChoiceOptionOperationSchema as $, surveyAssistantTranslateContentResultSchema as A, surveyContentSchema as At, surveyAssistantProtocolVersionSchema as B, MAX_USER_ERROR_MESSAGE_LENGTH as Bt, surveyAssistantSuggestedTextSchema as C, surveyValidationIssueSchema as Ct, surveyAssistantTaskRequestSchema as D, updateItemLabelOperationSchema as Dt, surveyAssistantTaskItemSummarySchema as E, updateItemColorOperationSchema as Et, surveyAssistantThreadTranscriptSchema as F, isSurveyAssistantErrorRetryable as Ft, surveyEditorUIContextSchema as G, surveyAssistantSnapshotSchema as H, isSurveyAssistantSensitiveMetadataKey as Ht, updateSurveyAssistantThreadInputSchema as I, parseSurveyAssistantError as It, assistantItemCreateModeSchema as J, assistantContentSurfaceSchema as K, SURVEY_ASSISTANT_PROTOCOL_VERSION as L, serializeSurveyAssistantError as Lt, createSurveyAssistantThreadInputSchema as M, responseNamingEditSchema as Mt, surveyAssistantThreadListSchema as N, responseSettingsChangesSchema as Nt, surveyAssistantTranslateContentEntrySchema as O, updateItemTranslationOperationSchema as Ot, surveyAssistantThreadSchema as P, responseSettingsEditSchema as Pt, SURVEY_OPERATION_KINDS as Q, rawSurveyDocumentSchema as R, surveyAssistantErrorCodeSchema as Rt, surveyAssistantSuggestResponseSettingsResultSchema as S, surveyPatchOperationSchema as St, surveyAssistantTaskInvocationModeSchema as T, updateChoiceOptionLabelOperationSchema as Tt, surveyDocumentSnapshotSchema as U, redactSurveyAssistantDiagnosticSecrets as Ut, surveyAssistantSnapshotPayloadSchema as V, getSurveyAssistantEmbeddedBinaryMarker as Vt, surveyDocumentVersionSchema as W, sanitizeSurveyAssistantDiagnosticText as Wt, assistantResponseSlotSchema as X, assistantItemTypeManifestSchema as Y, surveyAssistantCapabilityManifestSchema as Z, surveyAssistantSuggestItemLabelInputSchema as _, surveyAssistantValidationIssueSchema as _t, surveyApplyStatusSchema as a, reorderChoiceOptionsOperationSchema as at, surveyAssistantSuggestResponseNameResultSchema as b, surveyOperationSchema as bt, surveyAssistantDraftChangeEventSchema as c, surveyAssistantOperationSchema as ct, surveyBatchApplyResultSchema as d, surveyAssistantReorderChoiceOptionsOperationSchema as dt, createItemOperationSchema as et, surveyChangeSetSchema as f, surveyAssistantSurveyJsonPatchOperationSchema as ft, surveyAssistantKeySuggestionSchema as g, surveyAssistantUpdateItemTranslationOperationSchema as gt, surveyAssistantKeySuggestionCategorySchema as h, surveyAssistantUpdateItemLabelOperationSchema as ht, surveyApplyResultSchema as i, removeItemOperationSchema as it, SURVEY_ASSISTANT_ATTACHMENT_PART_TYPE as j, responseExportSettingsSchema as jt, surveyAssistantTranslateContentInputSchema as k, jsonValueSchema as kt, surveyAssistantTurnFinalSchema as l, surveyAssistantRemoveChoiceOptionOperationSchema as lt, surveyAssistantModelOptionSchema as m, surveyAssistantUpdateItemColorOperationSchema as mt, SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE as n, patchItemConfigOperationSchema as nt, surveyAssistantApplyOutcomeSchema as o, surveyAssistantAddChoiceOptionOperationSchema as ot, surveyAssistantModelCatalogSchema as p, surveyAssistantUpdateChoiceOptionLabelOperationSchema as pt, assistantItemAuthoringSchema as q, applyReceiptSchema as r, removeChoiceOptionOperationSchema as rt, surveyAssistantApplyPolicySchema as s, surveyAssistantCreateItemOperationSchema as st, SURVEY_ASSISTANT_TURN_FINAL_DATA_NAME as t, jsonPatchOperationSchema as tt, surveyAssistantTurnTerminationReasonSchema as u, surveyAssistantRemoveItemOperationSchema as ut, surveyAssistantSuggestItemLabelResultSchema as v, surveyAssistantValidationResultSchema as vt, surveyAssistantTaskContextSchema as w, surveyValidationResultSchema as wt, surveyAssistantSuggestResponseSettingsInputSchema as x, surveyOperationSchemasByKind as xt, surveyAssistantSuggestResponseNameInputSchema as y, surveyJsonPatchOperationSchema as yt, surveyAssistantDraftChangePreconditionSchema as z, surveyAssistantErrorInfoSchema as zt };
 
-//# sourceMappingURL=protocol-DJUP4gc0.mjs.map
+//# sourceMappingURL=protocol-CF4Bh_Ch.mjs.map