@case-framework/survey-assistant 0.1.0

package/dist/protocol-DV0ka9WT.mjs

@@ -0,0 +1,1032 @@
+import { z } from "zod";
+//#region src/protocol/errors.ts
+const surveyAssistantErrorCodeSchema = z.enum([
+	"attachment_unavailable",
+	"authorization_failed",
+	"model_unavailable",
+	"rate_limited",
+	"request_failed"
+]);
+const surveyAssistantErrorInfoSchema = z.object({
+	code: surveyAssistantErrorCodeSchema,
+	detail: z.string().optional()
+});
+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 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
+		});
+		if (parsed.success) return parsed.data;
+	}
+	const message = value instanceof Error ? value.message : typeof value === "string" ? value : typeof value === "object" && value !== null && "message" in value ? String(value.message) : "";
+	if (message.startsWith(ERROR_PREFIX)) try {
+		const parsed = surveyAssistantErrorInfoSchema.safeParse(JSON.parse(message.slice(28)));
+		if (parsed.success) return parsed.data;
+	} catch {}
+	return {
+		code: "request_failed",
+		...message.trim() ? { detail: message.trim() } : {}
+	};
+};
+//#endregion
+//#region src/protocol/content.ts
+const jsonValueSchema = z.lazy(() => z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.null(),
+	z.array(jsonValueSchema),
+	z.record(z.string(), jsonValueSchema)
+]));
+const contentAttributesSchema = z.record(z.string(), jsonValueSchema);
+const richTextStyleSchema = z.object({
+	weight: z.enum(["strong", "normal"]).optional(),
+	italic: z.enum(["italic", "normal"]).optional(),
+	underline: z.enum(["underline", "none"]).optional(),
+	color: z.enum([
+		"primary",
+		"accent",
+		"default"
+	]).optional()
+});
+const richTextTextInlineSchema = z.object({
+	type: z.literal("text"),
+	text: z.string().max(2e4),
+	style: richTextStyleSchema.optional(),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextTemplateInlineSchema = z.object({
+	type: z.literal("template"),
+	key: z.string().min(1).max(240),
+	style: richTextStyleSchema.optional(),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextLineBreakInlineSchema = z.object({
+	type: z.literal("lineBreak"),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextLinkChildInlineSchema = z.discriminatedUnion("type", [
+	richTextTextInlineSchema,
+	richTextTemplateInlineSchema,
+	richTextLineBreakInlineSchema
+]);
+const richTextLinkInlineSchema = z.object({
+	type: z.literal("link"),
+	href: z.string().min(1).max(2e3),
+	target: z.string().max(120).nullable().optional(),
+	rel: z.string().max(240).nullable().optional(),
+	title: z.string().max(1e3).nullable().optional(),
+	attrs: contentAttributesSchema.optional(),
+	children: z.array(richTextLinkChildInlineSchema).max(200)
+});
+const richTextInlineExtensionSchema = z.object({
+	type: z.literal("inlineExtension"),
+	name: z.string().min(1).max(120),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextInlineSchema = z.discriminatedUnion("type", [
+	richTextTextInlineSchema,
+	richTextTemplateInlineSchema,
+	richTextLinkInlineSchema,
+	richTextLineBreakInlineSchema,
+	richTextInlineExtensionSchema
+]);
+const textAlignmentSchema = z.enum([
+	"left",
+	"center",
+	"right",
+	"justify"
+]);
+const richTextParagraphBlockSchema = z.object({
+	type: z.literal("paragraph"),
+	children: z.array(richTextInlineSchema).max(500),
+	alignment: textAlignmentSchema.optional(),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextHeadingBlockSchema = z.object({
+	type: z.literal("heading"),
+	level: z.union([z.literal(1), z.literal(2)]),
+	children: z.array(richTextInlineSchema).max(500),
+	alignment: textAlignmentSchema.optional(),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextListItemBlockSchema = z.object({
+	type: z.literal("listItem"),
+	children: z.array(richTextParagraphBlockSchema).max(100),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextBulletListBlockSchema = z.object({
+	type: z.literal("bulletList"),
+	items: z.array(richTextListItemBlockSchema).max(100),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextImageDimensionSchema = z.union([z.object({
+	unit: z.literal("px"),
+	value: z.number().finite().nonnegative()
+}), z.object({
+	unit: z.literal("%"),
+	value: z.number().finite().nonnegative()
+})]);
+const richTextImageSourceSchema = z.discriminatedUnion("type", [z.object({
+	type: z.literal("asset"),
+	assetId: z.string().min(1).max(240)
+}), z.object({
+	type: z.literal("external"),
+	url: z.string().min(1).max(2e3)
+})]);
+const richTextImageBlockSchema = z.object({
+	type: z.literal("image"),
+	source: richTextImageSourceSchema,
+	alt: z.string().max(2e3).optional(),
+	caption: z.array(richTextParagraphBlockSchema).max(20).optional(),
+	size: z.object({
+		width: richTextImageDimensionSchema.optional(),
+		height: richTextImageDimensionSchema.optional(),
+		maxWidth: richTextImageDimensionSchema.optional(),
+		maxHeight: richTextImageDimensionSchema.optional()
+	}).optional(),
+	alignment: textAlignmentSchema.optional(),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextInfoBoxBlockSchema = z.object({
+	type: z.literal("infoBox"),
+	tone: z.enum(["info", "warning"]).optional(),
+	title: z.array(richTextInlineSchema).max(100).optional(),
+	collapsible: z.boolean().optional(),
+	defaultOpen: z.boolean().optional(),
+	children: z.array(richTextParagraphBlockSchema).max(100),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextSeparatorBlockSchema = z.object({
+	type: z.literal("separator"),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextBlockExtensionSchema = z.object({
+	type: z.literal("blockExtension"),
+	name: z.string().min(1).max(120),
+	attrs: contentAttributesSchema.optional()
+});
+const richTextBlockSchema = z.discriminatedUnion("type", [
+	richTextParagraphBlockSchema,
+	richTextHeadingBlockSchema,
+	richTextBulletListBlockSchema,
+	richTextImageBlockSchema,
+	richTextInfoBoxBlockSchema,
+	richTextSeparatorBlockSchema,
+	richTextBlockExtensionSchema
+]);
+const surveyContentSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("md"),
+		content: z.string().max(2e4)
+	}),
+	z.object({
+		type: z.literal("plain"),
+		content: z.string().max(2e4)
+	}),
+	z.object({
+		type: z.literal("richText"),
+		version: z.literal(1),
+		doc: z.object({
+			type: z.literal("doc"),
+			blocks: z.array(richTextBlockSchema).max(200)
+		})
+	})
+]);
+//#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 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." });
+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."),
+	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. The validator converts option labels into options.<optionId>.label translations."),
+	validations: z.record(z.string(), z.any()).optional(),
+	displayConditions: z.any().optional(),
+	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 jsonPatchOperationSchema = z.discriminatedUnion("op", [
+	z.object({
+		op: z.literal("add"),
+		path: jsonPointerPathSchema,
+		value: jsonValueSchema
+	}),
+	z.object({
+		op: z.literal("replace"),
+		path: jsonPointerPathSchema,
+		value: jsonValueSchema
+	}),
+	z.object({
+		op: z.literal("test"),
+		path: jsonPointerPathSchema,
+		value: jsonValueSchema
+	}),
+	z.object({
+		op: z.literal("remove"),
+		path: jsonPointerPathSchema
+	}),
+	z.object({
+		op: z.literal("move"),
+		from: jsonPointerPathSchema,
+		path: jsonPointerPathSchema
+	}),
+	z.object({
+		op: z.literal("copy"),
+		from: jsonPointerPathSchema,
+		path: jsonPointerPathSchema
+	})
+]);
+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()
+	}),
+	item: rawSurveyItemForCreateSchema,
+	translations: z.array(itemTranslationSchema).optional().describe("Top-level item translations for visible content, for example [{ \"locale\": \"en\", \"contentKey\": \"title\", \"plainText\": \"Question text\" }]. For formatted content, use the \"content\" field with a richText object. Put translations beside target and item, not inside item. 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
+});
+const updateItemLabelOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-item-label"),
+	itemId: itemIdentifierSchema,
+	itemLabel: z.string().max(200)
+});
+const updateItemColorOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-item-color"),
+	itemId: itemIdentifierSchema,
+	color: z.enum([
+		"#404040",
+		"#b91c1c",
+		"#c2410c",
+		"#a16207",
+		"#4d7c0f",
+		"#047857",
+		"#0369a1",
+		"#4338ca",
+		"#7e22ce",
+		"#86198f",
+		"#be123c"
+	]).describe("One of the Survey Editor's supported item-color swatches.")
+});
+const updateItemTranslationOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-item-translation"),
+	itemId: itemIdentifierSchema,
+	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." });
+const placedImageDimensionSchema = z.union([z.object({
+	unit: z.literal("px"),
+	value: z.number().finite().nonnegative()
+}), z.object({
+	unit: z.literal("%"),
+	value: z.number().finite().nonnegative().max(100)
+})]);
+const placedImageSourceSchema = z.discriminatedUnion("type", [z.object({
+	type: z.literal("asset"),
+	assetId: z.string().min(1).max(240)
+}), z.object({
+	type: z.literal("external"),
+	url: z.string().min(1).max(2e3)
+})]);
+const updatePlacedImageOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-placed-image"),
+	itemId: itemIdentifierSchema,
+	locale: z.string().min(1).max(40),
+	contentKey: z.string().min(1).max(240),
+	imageIndex: z.number().int().nonnegative().describe("Zero-based index among image blocks in the selected rich-text content value."),
+	expectedAssetId: z.string().min(1).max(240).optional(),
+	changes: z.object({
+		source: placedImageSourceSchema.optional(),
+		alt: z.string().max(2e3).nullable().optional(),
+		caption: z.string().max(2e4).nullable().optional(),
+		width: placedImageDimensionSchema.nullable().optional(),
+		height: placedImageDimensionSchema.nullable().optional(),
+		maxWidth: placedImageDimensionSchema.nullable().optional(),
+		maxHeight: placedImageDimensionSchema.nullable().optional(),
+		alignment: z.enum([
+			"left",
+			"center",
+			"right"
+		]).nullable().optional()
+	}).refine((changes) => Object.values(changes).some((value) => value !== void 0), { message: "Provide at least one placed-image property to change." })
+});
+const patchItemConfigOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("patch-item-config"),
+	itemId: itemIdentifierSchema,
+	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({
+	itemId: itemIdentifierSchema,
+	optionId: z.string().min(1).max(240).optional().describe("Choice option id when targeting an inline embedded form.")
+});
+const formTranslationsSchema = z.array(itemTranslationSchema).max(100).optional().describe("Translations written atomically with this form structure change. Content keys are relative to the form; embedded-form prefixes are added automatically.");
+const formFieldGroupInputSchema = z.object({
+	id: z.string().min(1).max(120),
+	layout: z.object({
+		base: z.number().int().min(1).max(12),
+		xs: z.number().int().min(1).max(12),
+		sm: z.number().int().min(1).max(12),
+		md: z.number().int().min(1).max(12),
+		xl: z.number().int().min(1).max(12)
+	}).optional(),
+	fields: z.array(z.unknown()).optional(),
+	hasDisplayCondition: z.boolean().optional()
+}).passthrough();
+const formFieldInputSchema = z.object({
+	id: z.string().min(1).max(120),
+	key: z.string().min(1).max(120),
+	type: z.enum([
+		"input",
+		"textarea",
+		"number",
+		"datepicker",
+		"switch",
+		"select",
+		"slider"
+	]),
+	controller: z.record(z.string(), z.unknown()),
+	required: z.boolean().optional(),
+	validations: z.array(z.record(z.string(), z.unknown())).optional()
+}).passthrough();
+const upsertFormFieldGroupOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("upsert-form-field-group"),
+	target: formTargetSchema,
+	index: z.number().int().min(0).optional(),
+	group: formFieldGroupInputSchema,
+	translations: formTranslationsSchema
+});
+const removeFormFieldGroupOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-form-field-group"),
+	target: formTargetSchema,
+	groupId: z.string().min(1).max(240)
+});
+const reorderFormFieldGroupsOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("reorder-form-field-groups"),
+	target: formTargetSchema,
+	groupIds: z.array(z.string().min(1).max(240)).min(1).max(100)
+});
+const upsertFormFieldOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("upsert-form-field"),
+	target: formTargetSchema,
+	groupId: z.string().min(1).max(240),
+	index: z.number().int().min(0).optional(),
+	field: formFieldInputSchema,
+	translations: formTranslationsSchema
+});
+const removeFormFieldOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-form-field"),
+	target: formTargetSchema,
+	fieldId: z.string().min(1).max(240)
+});
+const moveFormFieldOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("move-form-field"),
+	target: formTargetSchema,
+	fieldId: z.string().min(1).max(240),
+	targetGroupId: z.string().min(1).max(240),
+	index: z.number().int().min(0).optional()
+});
+const setEmbeddedFormOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("set-embedded-form"),
+	itemId: itemIdentifierSchema,
+	optionId: z.string().min(1).max(240),
+	form: z.object({
+		id: z.string().min(1).max(120),
+		fieldGroups: z.array(formFieldGroupInputSchema).max(100)
+	}).passthrough(),
+	translations: formTranslationsSchema
+});
+const removeEmbeddedFormOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-embedded-form"),
+	itemId: itemIdentifierSchema,
+	optionId: z.string().min(1).max(240)
+});
+const addChoiceOptionOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("add-choice-option"),
+	itemId: itemIdentifierSchema,
+	locale: z.string().min(1).max(40).optional(),
+	index: z.number().int().min(0).optional(),
+	option: choiceOptionInputSchema
+});
+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."),
+	locale: z.string().min(1).max(40).optional(),
+	label: z.string().min(1).max(1e3).describe("New respondent-visible option label.")
+});
+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.")
+});
+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.")
+});
+const removeItemOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-item"),
+	itemId: itemIdentifierSchema,
+	includeChildren: z.boolean().optional().describe("Must be true when removing a group item that has children.")
+});
+const moveItemOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("move-item"),
+	itemId: itemIdentifierSchema,
+	target: z.object({
+		parentItemId: itemIdentifierSchema,
+		index: z.number().int().min(0).optional()
+	})
+});
+const reorderItemsOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("reorder-items"),
+	parentItemId: itemIdentifierSchema,
+	itemIds: z.array(itemIdentifierSchema).min(1).max(200)
+});
+const updateSurveyMetadataOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-survey-metadata"),
+	values: z.record(z.string().min(1).max(240), z.string().max(2e4).nullable())
+});
+const updateSurveyPaginationOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-survey-pagination"),
+	value: z.object({
+		large: z.number().int().min(1).max(1e3),
+		small: z.number().int().min(1).max(1e3)
+	}).nullable()
+});
+const updateSurveyTranslationOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-survey-translation"),
+	locale: z.string().min(1).max(40),
+	surface: z.enum([
+		"surveyCardContent",
+		"navigationContent",
+		"validationMessages"
+	]),
+	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." });
+const removeSurveyLocaleOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-survey-locale"),
+	locale: z.string().min(1).max(40)
+});
+const imageAssetMetadataSchema = z.object({
+	name: z.string().max(500).optional(),
+	filename: z.string().max(500).optional(),
+	alt: z.string().max(2e3).optional(),
+	width: z.number().int().positive().optional(),
+	height: z.number().int().positive().optional()
+});
+const rawSurveyImageAssetSchema = z.object({
+	kind: z.literal("image"),
+	source: z.object({
+		type: z.literal("embedded"),
+		mediaType: z.string().regex(/^image\//),
+		encoding: z.literal("base64"),
+		data: z.string().min(1).max(8e6)
+	}),
+	metadata: imageAssetMetadataSchema.optional()
+});
+const setImageAssetOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("set-image-asset"),
+	assetId: z.string().min(1).max(240),
+	asset: rawSurveyImageAssetSchema
+});
+const updateImageAssetMetadataOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("update-image-asset-metadata"),
+	assetId: z.string().min(1).max(240),
+	metadata: z.object({
+		name: z.string().max(500).nullable().optional(),
+		filename: z.string().max(500).nullable().optional(),
+		alt: z.string().max(2e3).nullable().optional(),
+		width: z.number().int().positive().nullable().optional(),
+		height: z.number().int().positive().nullable().optional()
+	})
+});
+const removeImageAssetOperationSchema = z.object({
+	id: operationIdSchema,
+	kind: z.literal("remove-image-asset"),
+	assetId: z.string().min(1).max(240)
+});
+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.")
+});
+const asDiscriminable = (schema) => schema;
+const surveyOperationSchema = z.discriminatedUnion("kind", [
+	asDiscriminable(createItemOperationSchema),
+	asDiscriminable(updateItemKeyOperationSchema),
+	asDiscriminable(updateItemLabelOperationSchema),
+	asDiscriminable(updateItemColorOperationSchema),
+	asDiscriminable(updateItemTranslationOperationSchema),
+	asDiscriminable(updatePlacedImageOperationSchema),
+	asDiscriminable(patchItemConfigOperationSchema),
+	asDiscriminable(upsertFormFieldGroupOperationSchema),
+	asDiscriminable(removeFormFieldGroupOperationSchema),
+	asDiscriminable(reorderFormFieldGroupsOperationSchema),
+	asDiscriminable(upsertFormFieldOperationSchema),
+	asDiscriminable(removeFormFieldOperationSchema),
+	asDiscriminable(moveFormFieldOperationSchema),
+	asDiscriminable(setEmbeddedFormOperationSchema),
+	asDiscriminable(removeEmbeddedFormOperationSchema),
+	asDiscriminable(addChoiceOptionOperationSchema),
+	asDiscriminable(updateChoiceOptionLabelOperationSchema),
+	asDiscriminable(removeChoiceOptionOperationSchema),
+	asDiscriminable(reorderChoiceOptionsOperationSchema),
+	asDiscriminable(removeItemOperationSchema),
+	asDiscriminable(moveItemOperationSchema),
+	asDiscriminable(reorderItemsOperationSchema),
+	asDiscriminable(updateSurveyMetadataOperationSchema),
+	asDiscriminable(updateSurveyPaginationOperationSchema),
+	asDiscriminable(updateSurveyTranslationOperationSchema),
+	asDiscriminable(removeSurveyLocaleOperationSchema),
+	asDiscriminable(setImageAssetOperationSchema),
+	asDiscriminable(updateImageAssetMetadataOperationSchema),
+	asDiscriminable(removeImageAssetOperationSchema),
+	asDiscriminable(surveyPatchOperationSchema)
+]);
+const surveyValidationIssueSchema = z.object({
+	severity: z.enum(["error", "warning"]),
+	code: z.string(),
+	message: z.string(),
+	operationIndex: z.number().int().nonnegative().optional(),
+	operationId: z.string().optional(),
+	itemId: z.string().optional()
+});
+const surveyValidationResultSchema = z.object({
+	valid: z.boolean(),
+	issues: z.array(surveyValidationIssueSchema),
+	warnings: z.array(surveyValidationIssueSchema),
+	normalizedOperations: z.array(surveyOperationSchema)
+});
+const SURVEY_OPERATION_KINDS = [
+	"create-item",
+	"update-item-key",
+	"update-item-label",
+	"update-item-color",
+	"update-item-translation",
+	"update-placed-image",
+	"patch-item-config",
+	"upsert-form-field-group",
+	"remove-form-field-group",
+	"reorder-form-field-groups",
+	"upsert-form-field",
+	"remove-form-field",
+	"move-form-field",
+	"set-embedded-form",
+	"remove-embedded-form",
+	"add-choice-option",
+	"update-choice-option-label",
+	"remove-choice-option",
+	"reorder-choice-options",
+	"remove-item",
+	"move-item",
+	"reorder-items",
+	"update-survey-metadata",
+	"update-survey-pagination",
+	"update-survey-translation",
+	"remove-survey-locale",
+	"set-image-asset",
+	"update-image-asset-metadata",
+	"remove-image-asset",
+	"survey-json-patch"
+];
+const surveyJsonPatchOperationSchema = jsonPatchOperationSchema;
+const surveyAssistantCreateItemOperationSchema = createItemOperationSchema;
+const surveyAssistantUpdateItemKeyOperationSchema = updateItemKeyOperationSchema;
+const surveyAssistantUpdateItemLabelOperationSchema = updateItemLabelOperationSchema;
+const surveyAssistantUpdateItemColorOperationSchema = updateItemColorOperationSchema;
+const surveyAssistantUpdateItemTranslationOperationSchema = updateItemTranslationOperationSchema;
+const surveyAssistantAddChoiceOptionOperationSchema = addChoiceOptionOperationSchema;
+const surveyAssistantUpdateChoiceOptionLabelOperationSchema = updateChoiceOptionLabelOperationSchema;
+const surveyAssistantRemoveChoiceOptionOperationSchema = removeChoiceOptionOperationSchema;
+const surveyAssistantReorderChoiceOptionsOperationSchema = reorderChoiceOptionsOperationSchema;
+const surveyAssistantRemoveItemOperationSchema = removeItemOperationSchema;
+const surveyAssistantSurveyJsonPatchOperationSchema = surveyPatchOperationSchema;
+const surveyAssistantOperationSchema = surveyOperationSchema;
+const surveyAssistantValidationIssueSchema = surveyValidationIssueSchema;
+const surveyAssistantValidationResultSchema = surveyValidationResultSchema;
+//#endregion
+//#region src/protocol/capabilities.ts
+const assistantItemCreateModeSchema = z.enum([
+	"deterministic",
+	"interactive-only",
+	"unsupported"
+]);
+const assistantContentSurfaceSchema = z.object({
+	key: z.string().min(1),
+	role: z.enum([
+		"primary",
+		"secondary",
+		"option",
+		"field",
+		"validation"
+	]),
+	format: z.enum(["plain", "rich"]),
+	requiredOnCreate: z.boolean().optional(),
+	pattern: z.boolean().optional(),
+	aliases: z.array(z.string().min(1)).optional()
+});
+const assistantResponseSlotSchema = z.object({
+	key: z.string().min(1),
+	valueType: z.string().min(1)
+});
+const assistantItemAuthoringSchema = z.object({ configSummary: z.string().min(1).max(1e3).optional() });
+const assistantItemTypeManifestSchema = z.object({
+	itemType: z.string().min(1),
+	capabilityVersion: z.string().min(1),
+	displayName: z.string().min(1),
+	description: z.string().optional(),
+	defaultItemKeyPrefix: z.string().min(1).optional(),
+	create: assistantItemCreateModeSchema,
+	supportedOperations: z.array(z.enum(SURVEY_OPERATION_KINDS)),
+	contentSurfaces: z.array(assistantContentSurfaceSchema),
+	responseSlots: z.array(assistantResponseSlotSchema).optional(),
+	referenceTopics: z.array(z.string().min(1)).optional(),
+	authoring: assistantItemAuthoringSchema.optional()
+});
+const surveyAssistantCapabilityManifestSchema = z.object({
+	digest: z.string().min(1),
+	itemTypes: z.array(assistantItemTypeManifestSchema)
+});
+//#endregion
+//#region src/protocol/document.ts
+const SURVEY_ASSISTANT_PROTOCOL_VERSION = 1;
+const surveyAssistantProtocolVersionSchema = z.literal(1);
+const surveyDocumentVersionSchema = z.object({
+	sessionId: z.string().nullable(),
+	revision: z.number().int().nonnegative(),
+	historyIndex: z.number().int(),
+	contentHash: z.string().min(1),
+	capabilityDigest: z.string().min(1)
+});
+const surveyEditorUIContextSchema = z.object({
+	view: z.enum([
+		"item-editor",
+		"preview-mode",
+		"translation-mode",
+		"asset-manager"
+	]),
+	selectedItemId: z.string().optional(),
+	selectedLocale: z.string().min(1),
+	focusItemId: z.string().optional(),
+	recentItemIds: z.array(z.string()).max(10).optional(),
+	activeSurface: z.string().max(120).optional(),
+	openPanels: z.array(z.string().max(120)).max(12).optional(),
+	highlights: z.array(z.object({
+		kind: z.string().min(1).max(80),
+		itemId: z.string().optional(),
+		componentId: z.string().optional(),
+		label: z.string().max(240).optional(),
+		details: z.string().max(1e3).optional()
+	})).max(12).optional(),
+	history: z.object({
+		currentIndex: z.number().int(),
+		totalEntries: z.number().int().nonnegative(),
+		canUndo: z.boolean(),
+		canRedo: z.boolean(),
+		recent: z.array(z.object({
+			index: z.number().int().nonnegative(),
+			kind: z.enum(["survey-snapshot", "asset-change"]),
+			label: z.string(),
+			source: z.enum([
+				"user",
+				"system",
+				"assistant"
+			]).optional(),
+			timestamp: z.number().nonnegative(),
+			isCurrent: z.boolean()
+		})).max(12)
+	}).optional()
+});
+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),
+	surveyItems: z.array(rawSurveyItemSchema).min(1),
+	translations: rawSurveyTranslationsSchema.optional()
+}).passthrough();
+const surveyDocumentSnapshotSchema = z.object({
+	protocolVersion: surveyAssistantProtocolVersionSchema,
+	version: surveyDocumentVersionSchema,
+	survey: rawSurveyDocumentSchema,
+	ui: surveyEditorUIContextSchema,
+	capabilities: surveyAssistantCapabilityManifestSchema,
+	createdAt: z.string().min(1)
+});
+const surveyAssistantSnapshotSchema = surveyDocumentSnapshotSchema;
+const surveyAssistantSnapshotPayloadSchema = surveyDocumentSnapshotSchema;
+const surveyAssistantDraftChangePreconditionSchema = surveyDocumentVersionSchema;
+//#endregion
+//#region src/protocol/threads.ts
+const surveyAssistantThreadSchema = z.object({
+	id: z.string().min(1).max(240),
+	title: z.string().min(1).max(160),
+	titleMode: z.enum(["automatic", "manual"]),
+	createdAt: z.string().datetime(),
+	updatedAt: z.string().datetime()
+});
+const surveyAssistantThreadListSchema = z.object({ threads: z.array(surveyAssistantThreadSchema) });
+const surveyAssistantThreadTranscriptSchema = z.object({
+	thread: surveyAssistantThreadSchema,
+	messages: z.array(z.unknown())
+});
+const createSurveyAssistantThreadInputSchema = z.object({ title: z.string().trim().min(1).max(160).optional() });
+const updateSurveyAssistantThreadInputSchema = z.union([z.object({
+	mode: z.literal("automatic"),
+	title: z.string().trim().min(1).max(160).optional()
+}), z.object({
+	mode: z.literal("manual").optional(),
+	title: z.string().trim().min(1).max(160)
+})]);
+//#endregion
+//#region src/protocol/tasks.ts
+const surveyAssistantTaskInvocationModeSchema = z.enum(["user", "background"]);
+const surveyAssistantSuggestedTextSchema = z.object({ text: z.string().min(1) });
+const surveyAssistantKeySuggestionCategorySchema = z.enum([
+	"survey-pattern",
+	"compact",
+	"preferred",
+	"fair"
+]);
+const surveyAssistantKeySuggestionSchema = surveyAssistantSuggestedTextSchema.extend({
+	category: surveyAssistantKeySuggestionCategorySchema,
+	rationale: z.string().optional()
+});
+const surveyAssistantSuggestItemKeyInputSchema = z.object({
+	itemId: z.string().min(1),
+	draftKey: z.string(),
+	currentKey: z.string(),
+	siblingKeys: z.array(z.string()),
+	maxSuggestions: z.number().int().positive().optional()
+});
+const surveyAssistantSuggestItemKeyResultSchema = z.object({ suggestions: z.array(surveyAssistantKeySuggestionSchema) });
+const surveyAssistantSuggestItemLabelInputSchema = z.object({
+	itemId: z.string().min(1),
+	draftLabel: z.string(),
+	itemType: z.string().min(1),
+	locale: z.string().min(1).optional(),
+	maxSuggestions: z.number().int().positive().optional()
+});
+const surveyAssistantSuggestItemLabelResultSchema = z.object({ suggestions: z.array(surveyAssistantSuggestedTextSchema) });
+const surveyAssistantTranslateContentEntrySchema = z.object({
+	id: z.string().min(1),
+	text: z.string(),
+	kind: z.string().min(1)
+});
+const surveyAssistantTranslateContentInputSchema = z.object({
+	sourceLocale: z.string().min(1),
+	targetLocales: z.array(z.string().min(1)).min(1),
+	entries: z.array(surveyAssistantTranslateContentEntrySchema).min(1)
+});
+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(),
+	itemType: z.string().min(1),
+	itemLabel: z.string().optional(),
+	visibleText: z.array(z.object({
+		locale: z.string().min(1),
+		contentKey: z.string().min(1),
+		text: z.string()
+	})),
+	visibleTextTruncated: z.boolean()
+});
+const namingRelationshipSchema = z.enum([
+	"sibling",
+	"same-type",
+	"survey"
+]);
+const surveyAssistantTaskContextSchema = z.object({
+	document: z.object({
+		revision: z.number().int().nonnegative(),
+		contentHash: z.string().min(1),
+		capabilityDigest: z.string().min(1)
+	}),
+	survey: z.object({
+		key: z.string().optional(),
+		locales: z.array(z.string()),
+		itemCount: z.number().int().nonnegative(),
+		selectedLocale: z.string().min(1)
+	}),
+	focus: z.object({
+		item: surveyAssistantTaskItemSummarySchema,
+		parent: surveyAssistantTaskItemSummarySchema.optional(),
+		ancestorPath: z.array(surveyAssistantTaskItemSummarySchema),
+		siblingKeys: z.array(z.string()),
+		siblingItems: z.array(surveyAssistantTaskItemSummarySchema),
+		siblingItemCount: z.number().int().nonnegative(),
+		siblingItemsTruncated: z.boolean(),
+		relatedItems: z.array(surveyAssistantTaskItemSummarySchema),
+		relatedItemCount: z.number().int().nonnegative(),
+		relatedItemsTruncated: z.boolean()
+	}).optional(),
+	naming: z.object({
+		keyExamples: z.array(z.object({
+			itemId: z.string().min(1),
+			itemType: z.string().min(1),
+			key: z.string(),
+			relationship: namingRelationshipSchema
+		})),
+		keyExampleCount: z.number().int().nonnegative(),
+		keyExamplesTruncated: z.boolean(),
+		labelExamples: z.array(z.object({
+			itemId: z.string().min(1),
+			itemType: z.string().min(1),
+			key: z.string(),
+			label: z.string(),
+			relationship: namingRelationshipSchema
+		})),
+		labelExampleCount: z.number().int().nonnegative(),
+		labelExamplesTruncated: z.boolean()
+	}).optional(),
+	translation: z.object({
+		examples: z.array(z.object({
+			itemId: z.string().min(1),
+			contentKey: z.string().min(1),
+			values: z.record(z.string(), z.string())
+		})),
+		exampleCount: z.number().int().nonnegative(),
+		examplesTruncated: z.boolean()
+	}).optional()
+});
+const taskRequestBase = {
+	context: surveyAssistantTaskContextSchema,
+	mode: surveyAssistantTaskInvocationModeSchema.optional(),
+	modelId: z.string().trim().min(1).max(240).optional()
+};
+const surveyAssistantTaskRequestSchema = z.discriminatedUnion("taskId", [
+	z.object({
+		...taskRequestBase,
+		taskId: z.literal("suggest-item-key"),
+		input: surveyAssistantSuggestItemKeyInputSchema
+	}),
+	z.object({
+		...taskRequestBase,
+		taskId: z.literal("suggest-item-label"),
+		input: surveyAssistantSuggestItemLabelInputSchema
+	}),
+	z.object({
+		...taskRequestBase,
+		taskId: z.literal("translate-content"),
+		input: surveyAssistantTranslateContentInputSchema
+	})
+]);
+//#endregion
+//#region src/protocol/models.ts
+const surveyAssistantModelOptionSchema = z.object({
+	id: z.string().trim().min(1).max(240),
+	label: z.string().trim().min(1).max(240)
+});
+const surveyAssistantModelCatalogSchema = z.object({
+	defaultModelId: z.string().trim().min(1).max(240),
+	models: z.array(surveyAssistantModelOptionSchema).min(1)
+}).refine(({ defaultModelId, models }) => models.some((model) => model.id === defaultModelId), "The default model must be present in the model catalog.");
+//#endregion
+//#region src/protocol/lifecycle.ts
+const SURVEY_ASSISTANT_TURN_FINAL_DATA_NAME = "survey-assistant-turn-final";
+const SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE = `data-${SURVEY_ASSISTANT_TURN_FINAL_DATA_NAME}`;
+const surveyChangeSetSchema = z.object({
+	protocolVersion: surveyAssistantProtocolVersionSchema.default(1),
+	id: z.string().min(1),
+	turnId: z.string().min(1),
+	status: z.enum(["validated", "rejected"]),
+	summary: z.string().min(1).max(500),
+	operations: z.array(surveyOperationSchema),
+	supersedesChangeIds: z.array(z.string().min(1)).max(100).optional(),
+	precondition: surveyDocumentVersionSchema.optional(),
+	validation: surveyValidationResultSchema,
+	createdAt: z.string().min(1)
+});
+const surveyAssistantTurnFinalSchema = z.object({
+	protocolVersion: surveyAssistantProtocolVersionSchema,
+	turnId: z.string().min(1),
+	status: z.enum([
+		"completed",
+		"failed",
+		"aborted"
+	]),
+	executableChangeSetIds: z.array(z.string().min(1)),
+	blockedChangeSetIds: z.array(z.string().min(1)).max(100).optional(),
+	createdAt: z.string().min(1)
+}).superRefine((value, context) => {
+	if (value.status !== "completed" && value.executableChangeSetIds.length > 0) context.addIssue({
+		code: "custom",
+		message: "Failed or aborted turns cannot authorize executable change sets.",
+		path: ["executableChangeSetIds"]
+	});
+	if (new Set(value.executableChangeSetIds).size !== value.executableChangeSetIds.length) context.addIssue({
+		code: "custom",
+		message: "Executable change-set ids must be unique.",
+		path: ["executableChangeSetIds"]
+	});
+	const blockedChangeSetIds = value.blockedChangeSetIds ?? [];
+	if (new Set(blockedChangeSetIds).size !== blockedChangeSetIds.length) context.addIssue({
+		code: "custom",
+		message: "Blocked change-set ids must be unique.",
+		path: ["blockedChangeSetIds"]
+	});
+	if (blockedChangeSetIds.length > 0 && value.executableChangeSetIds.length > 0) context.addIssue({
+		code: "custom",
+		message: "A blocked turn cannot authorize executable change sets.",
+		path: ["executableChangeSetIds"]
+	});
+});
+const surveyAssistantApplyPolicySchema = z.enum([
+	"auto",
+	"review",
+	"deny"
+]);
+const surveyApplyStatusSchema = z.enum([
+	"applied",
+	"rejected",
+	"stale",
+	"failed"
+]);
+const surveyApplyResultSchema = z.object({
+	status: surveyApplyStatusSchema,
+	changeId: z.string(),
+	summary: z.string(),
+	message: z.string(),
+	appliedOperations: z.number().int().nonnegative(),
+	issues: z.array(surveyValidationIssueSchema).optional()
+});
+const surveyBatchApplyResultSchema = z.object({ results: z.array(surveyApplyResultSchema) });
+const applyReceiptSchema = z.object({
+	protocolVersion: surveyAssistantProtocolVersionSchema,
+	turnId: z.string().min(1),
+	changeSetId: z.string().min(1),
+	beforeVersion: surveyDocumentVersionSchema,
+	afterVersion: surveyDocumentVersionSchema.optional(),
+	status: surveyApplyStatusSchema,
+	operationCount: z.number().int().nonnegative(),
+	commit: z.object({
+		id: z.string().min(1).optional(),
+		index: z.number().int().optional()
+	}).optional(),
+	issues: z.array(surveyValidationIssueSchema).optional(),
+	createdAt: z.string().min(1)
+});
+const surveyAssistantDraftChangeEventSchema = surveyChangeSetSchema;
+//#endregion
+export { removeItemOperationSchema as $, surveyAssistantThreadTranscriptSchema as A, surveyAssistantErrorInfoSchema as At, surveyEditorUIContextSchema as B, surveyAssistantTaskRequestSchema as C, updateItemLabelOperationSchema as Ct, createSurveyAssistantThreadInputSchema as D, parseSurveyAssistantError as Dt, surveyAssistantTranslateContentResultSchema as E, surveyContentSchema as Et, surveyAssistantProtocolVersionSchema as F, assistantResponseSlotSchema as G, assistantItemAuthoringSchema as H, surveyAssistantSnapshotPayloadSchema as I, addChoiceOptionOperationSchema as J, surveyAssistantCapabilityManifestSchema as K, surveyAssistantSnapshotSchema as L, SURVEY_ASSISTANT_PROTOCOL_VERSION as M, rawSurveyDocumentSchema as N, surveyAssistantThreadListSchema as O, serializeSurveyAssistantError as Ot, surveyAssistantDraftChangePreconditionSchema as P, removeChoiceOptionOperationSchema as Q, surveyDocumentSnapshotSchema as R, surveyAssistantTaskItemSummarySchema as S, updateItemKeyOperationSchema as St, surveyAssistantTranslateContentInputSchema as T, jsonValueSchema as Tt, assistantItemCreateModeSchema as U, assistantContentSurfaceSchema as V, assistantItemTypeManifestSchema as W, jsonPatchOperationSchema as X, createItemOperationSchema as Y, patchItemConfigOperationSchema as Z, surveyAssistantSuggestItemLabelInputSchema as _, surveyPatchOperationSchema as _t, surveyApplyStatusSchema as a, surveyAssistantRemoveItemOperationSchema as at, surveyAssistantTaskContextSchema as b, updateChoiceOptionLabelOperationSchema as bt, surveyAssistantTurnFinalSchema as c, surveyAssistantUpdateChoiceOptionLabelOperationSchema as ct, surveyAssistantModelCatalogSchema as d, surveyAssistantUpdateItemLabelOperationSchema as dt, reorderChoiceOptionsOperationSchema as et, surveyAssistantModelOptionSchema as f, surveyAssistantUpdateItemTranslationOperationSchema as ft, surveyAssistantSuggestItemKeyResultSchema as g, surveyOperationSchema as gt, surveyAssistantSuggestItemKeyInputSchema as h, surveyJsonPatchOperationSchema as ht, surveyApplyResultSchema as i, surveyAssistantRemoveChoiceOptionOperationSchema as it, updateSurveyAssistantThreadInputSchema as j, surveyAssistantThreadSchema as k, surveyAssistantErrorCodeSchema as kt, surveyBatchApplyResultSchema as l, surveyAssistantUpdateItemColorOperationSchema as lt, surveyAssistantKeySuggestionSchema as m, surveyAssistantValidationResultSchema as mt, SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE as n, surveyAssistantCreateItemOperationSchema as nt, surveyAssistantApplyPolicySchema as o, surveyAssistantReorderChoiceOptionsOperationSchema as ot, surveyAssistantKeySuggestionCategorySchema as p, surveyAssistantValidationIssueSchema as pt, SURVEY_OPERATION_KINDS as q, applyReceiptSchema as r, surveyAssistantOperationSchema as rt, surveyAssistantDraftChangeEventSchema as s, surveyAssistantSurveyJsonPatchOperationSchema as st, SURVEY_ASSISTANT_TURN_FINAL_DATA_NAME as t, surveyAssistantAddChoiceOptionOperationSchema as tt, surveyChangeSetSchema as u, surveyAssistantUpdateItemKeyOperationSchema as ut, surveyAssistantSuggestItemLabelResultSchema as v, surveyValidationIssueSchema as vt, surveyAssistantTranslateContentEntrySchema as w, updateItemTranslationOperationSchema as wt, surveyAssistantTaskInvocationModeSchema as x, updateItemColorOperationSchema as xt, surveyAssistantSuggestedTextSchema as y, surveyValidationResultSchema as yt, surveyDocumentVersionSchema as z };
+
+//# sourceMappingURL=protocol-DV0ka9WT.mjs.map