@case-framework/survey-assistant 0.2.2 → 0.3.0

package/dist/{tools-wgLen05n.mjs → tools-Dg9HZrYU.mjs}

@@ -1,16 +1,16 @@
-import { G as assistantItemTypeManifestSchema, J as SURVEY_OPERATION_KINDS, _t as surveyOperationSchema, u as surveyChangeSetSchema, vt as surveyOperationSchemasByKind } from "./protocol-DpCYmCjr.mjs";
-import { a as getDeterministicCreateItemTypes, o as inspectAssistantItem, s as resolveAssistantCapabilityReference } from "./capabilities-DKbNCnBf.mjs";
-import { A as getRawSurvey, B as resolveItemSummary, C as clampLimit, F as mapKeyIndexById, H as summarizeFocusItemNode, I as mapOutlineById, J as translationEntrySchema, K as summarizeOutlineNode, L as mapRawItemsById, M as itemConfigDetailsSchema, N as itemMatchesQuery, P as itemSummarySchema, R as normalizeText, U as summarizeItemById, V as sliceWithCursor, W as summarizeKeyIndexEntries, Y as unique, _ as buildConfigSearchText, b as buildItemTranslationEntries, d as normalizeSurveyChangeOperations, f as buildExpressionMutationPatches, j as getRawSurveyItems, k as getKeyIndexEntries, l as createSurveyChangeSet, p as expressionMutationSchema, q as summarizeRawItem, t as auditSurvey, v as buildEmbeddedFormDetails, w as findDirectChildrenByFullKey, y as buildItemConfigDetails } from "./engine-0AJrv0hI.mjs";
-import { o as requireSurveyAssistantTurnState, r as getSurveyAssistantEngineContext } from "./request-context-BBzU3VdG.mjs";
-import { n as surveyAuthoringReferenceTopics, r as surveyAuthoringReferences, t as getBuiltInItemTypeAuthoringReference } from "./authoring-references-DYuOAdVx.mjs";
+import { X as SURVEY_OPERATION_KINDS, bt as surveyOperationSchemasByKind, f as surveyChangeSetSchema, q as assistantItemTypeManifestSchema, yt as surveyOperationSchema } from "./protocol-DATvkr1S.mjs";
+import { d as getDeterministicCreateItemTypes, f as inspectAssistantItem, p as resolveAssistantCapabilityReference } from "./form-authoring-DCd9XfXf.mjs";
+import { A as getRawSurvey, B as resolveItemSummary, C as clampLimit, F as mapKeyIndexById, H as summarizeFocusItemNode, I as mapOutlineById, J as translationEntrySchema, K as summarizeOutlineNode, L as mapRawItemsById, M as itemConfigDetailsSchema, N as itemMatchesQuery, P as itemSummarySchema, R as normalizeText, U as summarizeItemById, V as sliceWithCursor, W as summarizeKeyIndexEntries, Y as unique, _ as buildConfigSearchText, b as buildItemTranslationEntries, d as normalizeSurveyChangeOperations, f as buildExpressionMutationPatches, i as auditSurvey, j as getRawSurveyItems, k as getKeyIndexEntries, l as createSurveyChangeSet, p as expressionMutationSchema, q as summarizeRawItem, v as buildEmbeddedFormDetails, w as findDirectChildrenByFullKey, y as buildItemConfigDetails } from "./engine-CWTuN3o2.mjs";
+import { r as getSurveyAssistantEngineContext, s as requireSurveyAssistantTurnState } from "./request-context-BEjnaaFr.mjs";
+import { i as surveyAuthoringReferences, n as getBuiltInItemTypeAuthoringReference, r as surveyAuthoringReferenceTopics, t as builtInSurveyAuthoringItemTypes } from "./authoring-references-yyYC4Ydi.mjs";
 import { z } from "zod";
-import { JsonPatchError, SURVEY_EDITOR_ITEM_COLORS, encodeJsonPointerSegment, getAssetUsagesFromContent, getValueAtJsonPointer } from "@case-framework/survey-core";
+import { JsonPatchError, SURVEY_EDITOR_ITEM_COLORS, encodeJsonPointerSegment, getAssetUsagesFromContent, getContentPlainText, getValueAtJsonPointer } from "@case-framework/survey-core";
 import { randomUUID } from "node:crypto";
 import { createTool, isValidationError } from "@mastra/core/tools";
 //#region src/server/operation-contract-reference.ts
 const isSurveyOperationKind = (value) => SURVEY_OPERATION_KINDS.includes(value);
 const SURVEY_OPERATION_CONTRACT_DETAIL_LEVELS = ["compact", "full"];
-const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const summarizeLargeSchema = (schema, propertyName) => {
 	const description = typeof schema.description === "string" ? schema.description : propertyName ? `Canonical value for "${propertyName}".` : "Canonical value.";
 	const type = typeof schema.type === "string" ? schema.type : void 0;
@@ -21,7 +21,7 @@ const summarizeLargeSchema = (schema, propertyName) => {
 };
 const compactJsonSchema = (value, propertyName, depth = 0) => {
 	if (Array.isArray(value)) return value.map((entry) => compactJsonSchema(entry, propertyName, depth + 1));
-	if (!isRecord$1(value)) return value;
+	if (!isRecord$2(value)) return value;
 	if (typeof value.$ref === "string") return { description: "Recursive structured value omitted from this compact reference; request full detail only for protocol debugging." };
 	if (depth >= 3 && JSON.stringify(value).length > 12e3) return summarizeLargeSchema(value, propertyName);
 	const compact = {};
@@ -39,7 +39,7 @@ const compactJsonSchema = (value, propertyName, depth = 0) => {
 		"required",
 		"additionalProperties"
 	]) if (value[key] !== void 0) compact[key] = value[key];
-	if (isRecord$1(value.properties)) compact.properties = Object.fromEntries(Object.entries(value.properties).map(([key, schema]) => [key, compactJsonSchema(schema, key, depth + 1)]));
+	if (isRecord$2(value.properties)) compact.properties = Object.fromEntries(Object.entries(value.properties).map(([key, schema]) => [key, compactJsonSchema(schema, key, depth + 1)]));
 	if (value.items !== void 0) compact.items = compactJsonSchema(value.items, propertyName, depth + 1);
 	for (const unionKey of ["oneOf", "anyOf"]) if (Array.isArray(value[unionKey])) compact[unionKey] = value[unionKey].map((entry) => compactJsonSchema(entry, propertyName, depth + 1));
 	return compact;
@@ -54,6 +54,7 @@ const formatItemCapabilityProfile = (manifest, kind) => {
 		`${manifest.displayName}: ${manifest.description ?? "No additional description."}`,
 		`Creation mode: ${manifest.create}.`,
 		manifest.authoring?.configSummary ? `Configuration: ${manifest.authoring.configSummary}` : void 0,
+		manifest.creationPresets?.length ? `Available creation preset ids: ${manifest.creationPresets.map((preset) => `\`${preset.id}\``).join(", ")}. Use the server-trusted configuration guidance above for their semantics.` : void 0,
 		fixedSurfaces.length > 0 ? `Fixed content surfaces: ${fixedSurfaces.map((surface) => surface.key).join(", ")}.` : "Fixed content surfaces: none.",
 		patternedSurfaces.length > 0 ? `Dynamic content surfaces: ${patternedSurfaces.map((surface) => surface.key).join(", ")}.` : void 0,
 		kind === "create-item" && requiredSurfaces.length > 0 ? `Required on creation: ${requiredSurfaces.map((surface) => surface.key).join(", ")}.` : void 0,
@@ -87,6 +88,55 @@ const formatSurveyOperationContractReference = (kind, options = {}) => {
 	].join("\n");
 };
 //#endregion
+//#region src/server/canonical-name-suggestions.ts
+const CANONICAL_ACTION_TOKENS = {
+	add: "create",
+	append: "create",
+	create: "create",
+	delete: "remove",
+	edit: "update",
+	insert: "create",
+	modify: "update",
+	patch: "update",
+	relocate: "move",
+	remove: "remove",
+	reorder: "reorder",
+	replace: "update",
+	set: "update",
+	sort: "reorder",
+	update: "update"
+};
+const tokenizeCanonicalName = (value) => value.normalize("NFKD").replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().split(/[^a-z0-9]+/).filter(Boolean).map((token) => CANONICAL_ACTION_TOKENS[token] ?? token);
+const editDistance = (left, right) => {
+	const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+	for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
+		const current = [leftIndex];
+		for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) current[rightIndex] = Math.min((current[rightIndex - 1] ?? 0) + 1, (previous[rightIndex] ?? 0) + 1, (previous[rightIndex - 1] ?? 0) + (left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1));
+		previous.splice(0, previous.length, ...current);
+	}
+	return previous[right.length] ?? 0;
+};
+const scoreCanonicalName = (input, candidate) => {
+	const inputTokens = tokenizeCanonicalName(input);
+	const candidateTokens = tokenizeCanonicalName(candidate);
+	const normalizedInput = inputTokens.join("-");
+	const normalizedCandidate = candidateTokens.join("-");
+	if (!normalizedInput || !normalizedCandidate) return 0;
+	if (normalizedInput === normalizedCandidate) return 4;
+	const maximumLength = Math.max(normalizedInput.length, normalizedCandidate.length);
+	const similarity = 1 - editDistance(normalizedInput, normalizedCandidate) / maximumLength;
+	const candidateTokenSet = new Set(candidateTokens);
+	const tokenCoverage = inputTokens.filter((token) => candidateTokenSet.has(token)).length / Math.max(inputTokens.length, candidateTokens.length);
+	const sameFinalToken = inputTokens.at(-1) === candidateTokens.at(-1) ? .5 : 0;
+	const sameFirstToken = inputTokens[0] === candidateTokens[0] ? .2 : 0;
+	return similarity + tokenCoverage + sameFinalToken + sameFirstToken;
+};
+/** Suggests registry-derived canonical names without silently accepting an alias. */
+const suggestCanonicalNames = (input, candidates, limit = 3) => [...new Set(candidates)].filter((candidate) => candidate !== input).map((candidate) => ({
+	candidate,
+	score: scoreCanonicalName(input, candidate)
+})).filter((entry) => entry.score >= .9).sort((left, right) => right.score - left.score || left.candidate.localeCompare(right.candidate)).slice(0, Math.max(0, limit)).map((entry) => entry.candidate);
+//#endregion
 //#region src/server/tools/tool-model-output.ts
 const FALLBACK_MODEL_TEXT = "The tool returned no model-readable output. Review the tool arguments and retry with valid values.";
 const unwrapToolOutput$1 = (value) => value && typeof value === "object" && "output" in value && value.output !== void 0 ? value.output : value;
@@ -110,25 +160,31 @@ const toTextModelOutput = (value, summarize) => {
 //#region src/server/tools/survey-authoring-reference-tool.ts
 const TOOL_ID$10 = "survey_authoring_reference";
 const topicSchema = z.string().min(1).max(120);
+const inputSchema$10 = z.object({
+	topic: topicSchema.describe("The narrow authoring reference to load."),
+	itemType: z.string().min(1).max(120).optional().describe("Installed item type to focus. With topic \"item-types\", returns only that item type section instead of the combined reference."),
+	operationKind: z.string().min(1).max(120).optional().describe("For topic assistant-operations, return only this operation's generated canonical field contract."),
+	detail: z.enum(SURVEY_OPERATION_CONTRACT_DETAIL_LEVELS).optional().describe("Contract detail for assistant-operations. Use \"compact\" for authoring and \"full\" only for protocol debugging."),
+	reason: z.string().max(500).optional().describe("Short reason this reference is needed.")
+});
+const outputSchema$8 = z.object({
+	ok: z.boolean(),
+	topic: topicSchema,
+	itemType: z.string().optional(),
+	operationKind: z.string().optional(),
+	detail: z.enum(SURVEY_OPERATION_CONTRACT_DETAIL_LEVELS).optional(),
+	title: z.string(),
+	content: z.string()
+});
+const formatCanonicalNameRecovery = (input, candidates, noun) => {
+	const suggestions = suggestCanonicalNames(input, candidates);
+	return suggestions.length > 0 ? ` Closest canonical ${noun}${suggestions.length === 1 ? "" : "s"}: ${suggestions.map((value) => `"${value}"`).join(", ")}. Retry with the intended canonical name.` : " Retry without the focused name to load the available catalog.";
+};
 const surveyAuthoringReferenceTool = createTool({
 	id: TOOL_ID$10,
 	description: "Load one narrow CASE authoring reference. With topic \"item-types\", pass itemType to load only that type. For a survey_change operation, use topic \"assistant-operations\" with operationKind and optionally itemType to compose the structural contract with that installed item capability. Compact detail is the authoring default; full detail is only for protocol debugging.",
-	inputSchema: z.object({
-		topic: topicSchema.describe("The narrow authoring reference to load."),
-		itemType: z.string().min(1).max(120).optional().describe("Installed item type to focus. With topic \"item-types\", returns only that item type section instead of the combined reference."),
-		operationKind: z.string().min(1).max(120).optional().describe("For topic assistant-operations, return only this operation's generated canonical field contract."),
-		detail: z.enum(SURVEY_OPERATION_CONTRACT_DETAIL_LEVELS).optional().describe("Contract detail for assistant-operations. Use \"compact\" for authoring and \"full\" only for protocol debugging."),
-		reason: z.string().max(500).optional().describe("Short reason this reference is needed.")
-	}),
-	outputSchema: z.object({
-		ok: z.boolean(),
-		topic: topicSchema,
-		itemType: z.string().optional(),
-		operationKind: z.string().optional(),
-		detail: z.enum(SURVEY_OPERATION_CONTRACT_DETAIL_LEVELS).optional(),
-		title: z.string(),
-		content: z.string()
-	}),
+	inputSchema: inputSchema$10,
+	outputSchema: outputSchema$8,
 	mcp: { annotations: {
 		title: "Read authoring reference",
 		readOnlyHint: true,
@@ -140,6 +196,7 @@ const surveyAuthoringReferenceTool = createTool({
 		const contractDetail = inputData.detail ?? "compact";
 		const engineContext = getSurveyAssistantEngineContext(context?.requestContext);
 		const itemCapability = inputData.itemType ? engineContext?.trustedCapabilities?.byItemType.get(inputData.itemType)?.manifest ?? engineContext?.capabilities.itemTypes.find((entry) => entry.itemType === inputData.itemType) : void 0;
+		const availableItemTypes = [...builtInSurveyAuthoringItemTypes, ...engineContext?.capabilities.itemTypes.map((entry) => entry.itemType) ?? []];
 		if (inputData.operationKind && inputData.topic !== "assistant-operations") return {
 			ok: false,
 			topic: inputData.topic,
@@ -155,16 +212,16 @@ const surveyAuthoringReferenceTool = createTool({
 				operationKind: inputData.operationKind,
 				detail: contractDetail,
 				title: "Operation contract unavailable",
-				content: `No built-in survey_change operation named "${inputData.operationKind}" is available.`
+				content: `No built-in survey_change operation named "${inputData.operationKind}" is available.` + formatCanonicalNameRecovery(inputData.operationKind, SURVEY_OPERATION_KINDS, "operation")
 			};
-			if (inputData.itemType && !itemCapability) return {
+			if (inputData.itemType && !itemCapability && !getBuiltInItemTypeAuthoringReference(inputData.itemType)) return {
 				ok: false,
 				topic: inputData.topic,
 				itemType: inputData.itemType,
 				operationKind: inputData.operationKind,
 				detail: contractDetail,
 				title: "Item capability unavailable",
-				content: `No installed survey item capability named "${inputData.itemType}" is available.`
+				content: `No installed survey item capability named "${inputData.itemType}" is available.` + formatCanonicalNameRecovery(inputData.itemType, availableItemTypes, "item type")
 			};
 			if (itemCapability && !itemCapability.supportedOperations.includes(inputData.operationKind)) return {
 				ok: false,
@@ -196,6 +253,13 @@ const surveyAuthoringReferenceTool = createTool({
 			topic: inputData.topic
 		}) : void 0;
 		const focusedBuiltInItemTypeReference = inputData.topic === "item-types" && inputData.itemType ? getBuiltInItemTypeAuthoringReference(inputData.itemType) : void 0;
+		if (inputData.itemType && !focusedBuiltInItemTypeReference && !capability && !capabilityReference) return {
+			ok: false,
+			topic: inputData.topic,
+			itemType: inputData.itemType,
+			title: "Item capability unavailable",
+			content: `No installed survey item capability named "${inputData.itemType}" is available.` + formatCanonicalNameRecovery(inputData.itemType, availableItemTypes, "item type")
+		};
 		const capabilityEntry = capabilityReference ? {
 			title: capabilityReference.title ?? `${capability?.manifest.displayName} authoring`,
 			content: capabilityReference.markdown
@@ -207,7 +271,7 @@ const surveyAuthoringReferenceTool = createTool({
 			itemType: inputData.itemType,
 			operationKind: inputData.operationKind,
 			title: "Reference unavailable",
-			content: inputData.itemType ? `No reference named "${inputData.topic}" is installed for item type "${inputData.itemType}".` : `No built-in reference named "${inputData.topic}" is available.`
+			content: (inputData.itemType ? `No reference named "${inputData.topic}" is installed for item type "${inputData.itemType}".` : `No built-in reference named "${inputData.topic}" is available.`) + formatCanonicalNameRecovery(inputData.topic, surveyAuthoringReferenceTopics, "reference")
 		};
 		return {
 			ok: true,
@@ -229,7 +293,8 @@ const OPERATIONS_DESCRIPTION = [
 	"Any translations owned by an operation must be inside that same operation object. Never put translations beside the survey_change operations array.",
 	"Create items with { kind: \"create-item\", target: { parentItemId, index? }, item: { id?, key, itemType, config }, translations? }. Put respondent content in top-level translations and item settings in item.config.",
 	"Use update-item-translation with itemId, locale, contentKey, and plainText for ordinary text or content for a complete structured value. Item titles and option/field labels are translations, not item labels.",
-	"Use remove-survey-locale with locale to remove an existing survey language; the final remaining locale cannot be removed.",
+	"Use add-survey-locale only when the user explicitly requests an empty language registration. An ordinary localization request requires real translation operations, which introduce the locale themselves.",
+	"Use remove-survey-locale with locale to destructively remove an existing survey language and all translations stored for it.",
 	"Each call adds a delta to this turn's validated draft. Later calls may target ids created by earlier successful calls in the same turn.",
 	"For an existing choice item, use add-choice-option with itemId, optional locale/index, and option: { id?, key?, label }; label is a plain string and creates its translation.",
 	"Every reorder replaces the complete inspected list: reorder-choice-options uses optionIds, reorder-form-field-groups uses groupIds, and reorder-items uses itemIds for every direct child. Include every existing entry exactly once in desired order.",
@@ -238,7 +303,7 @@ const OPERATIONS_DESCRIPTION = [
 	"Use update-placed-image only for an image placement that already exists in the live survey or validated turn draft.",
 	"When deleting referenced images and assets, include every reference-removal operation and remove-image-asset last in the same operations array.",
 	"Raw fallback is one { kind: \"survey-json-patch\", patches } operation containing all related survey-rooted edits; it must be the only operation in the call.",
-	"Keep each delta bounded; successful chunks accumulate automatically in the turn draft."
+	"Keep each delta bounded; this is a per-call constraint, not a reason to end the turn. Successful chunks accumulate automatically, so substantial requests should continue with later deltas while capacity remains."
 ].join(" ");
 const inputSchema$9 = z.object({
 	summary: z.string().min(1).max(500).describe("Short user-facing summary of the intended survey change."),
@@ -289,6 +354,7 @@ const describeOperationTarget = (operation) => {
 		case "update-survey-metadata":
 		case "update-survey-pagination": return operation.kind;
 		case "update-survey-translation": return `${operation.kind} ${operation.locale}:${operation.surface}:${operation.contentKey}`;
+		case "add-survey-locale":
 		case "remove-survey-locale": return `${operation.kind} ${operation.locale}`;
 		case "set-image-asset":
 		case "update-image-asset-metadata":
@@ -300,20 +366,48 @@ const describeOperationTarget = (operation) => {
 const summarizeValidation = (event) => {
 	const lines = [`${event.status === "validated" ? "Validated" : "Rejected"} survey change: ${event.summary}`];
 	if (event.status === "rejected") {
-		lines.push("Draft unchanged. Fix this same rejected target in another call; the previously validated draft is retained. An unrelated valid edit does not repair this rejection.");
+		lines.push("TURN APPLY STATE: BLOCKED. Draft unchanged. This rejection does not finalize the editor or end the active turn. Fix this same rejected target in another survey_change call; the previously validated request-local draft is retained only for that repair. An unrelated valid edit does not repair this rejection.", "If this response ends while the turn is blocked, no prepared change from this turn, including every previously validated change, will reach the live editor. Do not tell the user that request-local draft content exists in the editor; either repair the rejected target now or state that none of this turn's changes were applied.");
 		if (event.operations.length > 0) {
 			const checklist = event.operations.slice(0, 24).map(describeOperationTarget);
 			lines.push(`Unapplied target sample (${checklist.length} of ${event.operations.length}):\n${checklist.map((target) => `- ${target}`).join("\n")}`);
 			if (event.operations.length > checklist.length) lines.push(`The sample omits ${event.operations.length - checklist.length} additional operation target(s). The original tool input is authoritative; preserve its complete requested scope when retrying.`);
 		}
 	}
-	if (event.status === "validated") lines.push(`Draft updated (${event.operations.length} total operation${event.operations.length === 1 ? "" : "s"}). Later tools can inspect and edit the resulting draft state. The live editor is unchanged until successful turn completion.`);
+	if (event.status === "validated") {
+		lines.push(`Draft updated (${event.operations.length} total operation${event.operations.length === 1 ? "" : "s"}). Later tools can inspect and edit the resulting draft state. The live editor is unchanged until successful turn completion.`);
+		if (event.postChange) {
+			const unavailableItemCount = event.postChange.touchedItemCount - event.postChange.availableTouchedItemCount;
+			lines.push(`Canonical post-change preview (first occurrence in operation order; projected fields only): ${event.postChange.itemCount} survey item(s); locales ${event.postChange.locales.length}/${event.postChange.localeCount} shown; targets ${event.postChange.touchedTargets.length}/${event.postChange.targetCount} shown; available touched-item snapshots ${event.postChange.touchedItems.length}/${event.postChange.availableTouchedItemCount} shown${unavailableItemCount > 0 ? `; ${unavailableItemCount} touched item target(s) are absent after the change` : ""}.`);
+			lines.push(`Target preview: ${event.postChange.touchedTargets.join(", ") || "none"}. Absence from this bounded projection does not prove that a field or target is absent from the canonical draft.`);
+			for (const item of event.postChange.touchedItems) {
+				const translations = item.translations.map(({ contentKey, locale, textLength, textPreview, truncated }) => truncated ? `${locale}:${contentKey}=${JSON.stringify(`${textPreview}…`)} [truncated preview; ${textLength} characters total]` : `${locale}:${contentKey}=${JSON.stringify(textPreview)}`).join("; ");
+				lines.push(`- ${item.fullKey} (${item.itemType}, id ${item.itemId}); response slots ${item.responseSlots.length}/${item.responseSlotCount}: ${item.responseSlots.join(", ") || "none"}; translations ${item.translations.length}/${item.translationCount}: ${translations || "none"}`);
+			}
+			if (event.postChange.truncated) lines.push("The post-change preview is truncated. The validated draft still contains the complete change; inspect any relevant omitted target or field before claiming its exact post-change value.");
+		}
+	}
+	if (event.verification) {
+		lines.push(`Verification required before claiming completion (${event.verification.reasons.join(", ")}). Inspect the exact affected targets in the current draft; validation alone does not prove source fidelity or every omitted preview value.`);
+		if (event.verification.newAuditFindingCount > 0) {
+			lines.push(`New deterministic audit findings: ${event.verification.auditFindings.length}/${event.verification.newAuditFindingCount} shown.`);
+			for (const finding of event.verification.auditFindings) {
+				const location = [
+					finding.itemId,
+					finding.locale,
+					finding.contentKey
+				].filter(Boolean).join(":");
+				lines.push(`- ${finding.severity} ${finding.code}${location ? ` (${location})` : ""}: ${finding.messagePreview}${finding.truncated ? `… [truncated preview; ${finding.messageLength} characters total]` : ""}`);
+			}
+			if (event.verification.truncated) lines.push("Verification diagnostics are bounded. Use survey_audit or focused survey_inspect calls for the complete relevant state.");
+		}
+	}
 	if (event.validation.issues.length > 0) {
 		lines.push("Issues:");
 		for (const issue of event.validation.issues) lines.push(`- ${issue.code}: ${issue.message}`);
 		const issueCodes = new Set(event.validation.issues.map((issue) => issue.code));
-		if (issueCodes.has("missing-create-content") || issueCodes.has("missing-field-groups-wrapper") || issueCodes.has("missing-choice-options") || issueCodes.has("missing-choice-option-labels")) lines.push("Recovery hint: load the assistant-operations reference, then retry only the rejected delta. Put visible text in top-level translations[] beside item, config inside item.config, choice options in item.config.options, and form fields inside item.config.fieldGroups[].fields. Every choice option id needs a matching top-level translation whose contentKey is options.<optionId>.label.");
+		if (issueCodes.has("missing-create-content") || issueCodes.has("missing-field-groups-wrapper") || issueCodes.has("missing-choice-options") || issueCodes.has("missing-choice-option-labels") || issueCodes.has("missing-form-field-content") || issueCodes.has("missing-form-select-option-labels") || issueCodes.has("missing-form-field-labels") || issueCodes.has("missing-embedded-form-field-labels")) lines.push("Recovery hint: load the assistant-operations reference, then retry only the rejected delta. Put visible text in top-level translations[] beside item, config inside item.config, choice options in item.config.options, and form fields inside item.config.fieldGroups[].fields. Every choice option id needs a matching top-level translation whose contentKey is options.<optionId>.label.");
 		if (issueCodes.has("too-many-operations")) lines.push("Recovery hint: keep the same inspected survey context and split this rejected delta into smaller survey_change calls. Each successful call extends the same turn draft.");
+		if (issueCodes.has("item-already-in-target-parent")) lines.push("Recovery hint: remove unchanged same-parent move-item operations. To change sibling order within one parent, inspect its complete current children and use reorder-items instead.");
 	}
 	if (event.validation.warnings.length > 0) {
 		lines.push("Warnings:");
@@ -366,12 +460,12 @@ const prepareActionSchema = z.object({
 	mutations: z.array(expressionMutationSchema).min(1).max(40)
 });
 const inputSchema$8 = z.object({
-	action: z.enum(["context", "prepare"]).describe("Use context to inspect expression refs; use prepare to create expression edits."),
+	action: z.enum(["context", "prepare"]).describe("Choose exactly one envelope. Inspect with { \"action\": \"context\", \"itemIds\"?: [...], \"includeRawLocations\"?: true, \"reason\"?: \"...\" }; omit summary and mutations. Create edits with { \"action\": \"prepare\", \"summary\": \"...\", \"mutations\": [...] }; omit reason, itemIds, and includeRawLocations."),
 	reason: z.string().max(500).optional(),
-	itemIds: z.array(z.string().min(1).max(240)).max(12).optional().describe("For context: optional item ids/keys to focus existing expression locations."),
-	includeRawLocations: z.boolean().optional().describe("For context: include existing expression locations by raw item."),
-	summary: z.string().min(1).max(500).optional().describe("For prepare: user-facing summary."),
-	mutations: z.array(z.record(z.string(), z.unknown())).min(1).max(40).optional().describe("For prepare: expression mutation objects using kebab-case kind names. Item visibility shape: { kind: \"set-item-display-condition\", itemId: \"<existing-item-id>\", expression: { type: \"function\", functionName: \"eq\", arguments: [...] } }. expression is always CASE expression JSON, never a string or expression-language snippet. Other supported kinds set/clear component display/disabled conditions, validation expressions, prefills, and template values.")
+	itemIds: z.array(z.string().min(1).max(240)).max(12).optional().describe("Context action only: optional item ids/keys to focus existing expression locations. Omit for prepare."),
+	includeRawLocations: z.boolean().optional().describe("Context action only: include existing expression locations by raw item. Omit for prepare."),
+	summary: z.string().min(1).max(500).optional().describe("Prepare action only: required user-facing summary. Omit for context."),
+	mutations: z.array(z.record(z.string(), z.unknown())).min(1).max(40).optional().describe("Prepare action only: required expression mutation objects using kebab-case kind names; omit this field for context. Item visibility shape: { kind: \"set-item-display-condition\", itemId: \"<existing-item-id>\", expression: { type: \"function\", functionName: \"eq\", arguments: [...] } }. expression is always CASE expression JSON, never a string or expression-language snippet. Other supported kinds set/clear component display/disabled conditions, validation expressions, prefills, and template values.")
 }).strict().superRefine((value, ctx) => {
 	if (value.action !== "prepare") return;
 	if (!value.summary) ctx.addIssue({
@@ -442,7 +536,7 @@ const rejectedEvent = ({ issues, summary, turnId, warnings = [] }) => ({
 const summarizeDraftEvent = (event) => {
 	const lines = [`${event.status === "validated" ? "Validated" : "Rejected"} expression change: ${event.summary}`];
 	if (event.status === "validated") lines.push(`Draft updated (${event.operations.length} total operation${event.operations.length === 1 ? "" : "s"}). The expression is immediately visible to later tools in this turn.`);
-	if (event.status === "rejected") lines.push("Draft unchanged. Fix this same expression target; the previously validated draft is retained. An unrelated valid edit does not repair this rejection.");
+	if (event.status === "rejected") lines.push("TURN APPLY STATE: BLOCKED. Draft unchanged. Fix this same expression target; the previously validated request-local draft is retained only for that repair. An unrelated valid edit does not repair this rejection.", "If this response ends while the turn is blocked, no prepared change from this turn, including every previously validated change, will reach the live editor. Do not tell the user that request-local draft content exists in the editor; either repair the rejected target now or state that none of this turn's changes were applied.");
 	if (event.validation.issues.length > 0) {
 		lines.push("Issues:");
 		for (const issue of event.validation.issues) lines.push(`- ${issue.code}: ${issue.message}`);
@@ -1009,7 +1103,7 @@ const summarizeConfigDetails = (configDetails) => {
 	for (const option of configDetails.choiceOptions ?? []) {
 		lines.push(`- ${option.position}. option ${option.key ?? option.id} (id=${option.id}, labelContentKey=${option.labelContentKey})`);
 		if (option.embeddedFormItemId || option.embeddedFormFieldGroupCount) {
-			lines.push(`  embedded form: itemId=${option.embeddedFormItemId ?? "inline"}, fieldGroups=${option.embeddedFormFieldGroupCount ?? 0}`);
+			lines.push(`  embedded form: itemId=${option.embeddedFormItemId ?? "inline"}, fieldGroups=${option.embeddedFormFieldGroupCount ?? 0}, authoringMode=${option.embeddedFormAuthoringMode ?? "custom"}, simpleModeValid=${option.embeddedFormSimpleModeValid ?? true}`);
 			if (option.embeddedFormTranslationPrefix || option.embeddedFormResponseSlotPrefix) lines.push(`  embedded form keys: translationPrefix=${option.embeddedFormTranslationPrefix ?? "n/a"}, responseSlotPrefix=${option.embeddedFormResponseSlotPrefix ?? "n/a"}`);
 		}
 	}
@@ -1172,9 +1266,9 @@ const outputSchema$4 = z.object({
 		error: z.string().optional()
 	})).optional()
 });
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const getGroupChildren = (item) => {
-	if (!isRecord(item) || !isRecord(item.config) || !Array.isArray(item.config.items)) return [];
+	if (!isRecord$1(item) || !isRecord$1(item.config) || !Array.isArray(item.config.items)) return [];
 	return item.config.items.filter((entry) => typeof entry === "string");
 };
 const buildParentByChildId = (rawSurvey) => {
@@ -1267,7 +1361,7 @@ const buildItemValues = (snapshot, input) => {
 		const itemId = resolved.item.id;
 		const rawItemOutput = toOutputValue(resolved.item, input.valueCharacterLimit);
 		const translationsOutput = toOutputValue(getTranslationsByLocaleForItem(rawSurvey, itemId), input.valueCharacterLimit);
-		const translationsValue = "value" in translationsOutput && isRecord(translationsOutput.value) ? translationsOutput.value : void 0;
+		const translationsValue = "value" in translationsOutput && isRecord$1(translationsOutput.value) ? translationsOutput.value : void 0;
 		return {
 			identifier,
 			found: true,
@@ -1585,6 +1679,7 @@ const inspectActionSchema = z.enum([
 	"current-context",
 	"search-items",
 	"item-details",
+	"localization",
 	"assets",
 	"raw-json"
 ]);
@@ -1593,6 +1688,8 @@ const outlineModeSchema = z.enum([
 	"focused",
 	"children"
 ]);
+const MAX_RAW_JSON_PATHS_PER_RESULT = 20;
+const MAX_RAW_JSON_PATHS_PER_REQUEST = 100;
 const optionalInput = (schema) => z.preprocess((value) => value === null ? void 0 : value, schema.optional());
 const optionalArrayInput = (schema) => z.preprocess((value) => value === null || Array.isArray(value) && value.length === 0 ? void 0 : value, schema.optional());
 const optionalNonBlankString = (maxLength) => z.preprocess((value) => value === null || typeof value === "string" && value.trim().length === 0 ? void 0 : value, z.string().min(1).max(maxLength).optional());
@@ -1608,10 +1705,13 @@ const inputSchema$3 = z.object({
 		"history"
 	])).min(1).max(6)).describe("For current-context: context sections to inspect. Empty means omitted."),
 	query: optionalNonBlankString(180).describe("For search-items: text to search across survey content. For assets: optional asset id, filename, name, ALT text, or media type filter. For current-context outline: optional key/fullKey/label filter."),
+	sourceLocale: optionalNonBlankString(40).describe("For localization: source locale to translate. Defaults to the selected editor locale."),
+	targetLocale: optionalNonBlankString(40).describe("For localization: required target locale whose coverage should be inspected."),
+	missingOnly: optionalInput(z.boolean()).describe("For localization: return only source surfaces that do not yet exist in the target locale."),
 	itemRef: optionalNonBlankString(240).describe("For current-context outline, item-details, or raw-json: item id, key, fullKey, visible label, or \"selected\"."),
-	cursor: optionalNonBlankString(240).describe("For current-context/search-items pagination: numeric cursor from a previous result."),
+	cursor: optionalNonBlankString(240).describe("For current-context, search-items, or localization pagination: numeric cursor from a previous result."),
 	outlineMode: optionalInput(outlineModeSchema).describe("For current-context outline: \"full\" pages all survey items, \"focused\" returns the selected/focused neighborhood, and \"children\" returns direct children of itemRef."),
-	paths: optionalArrayInput(z.array(z.string().min(1).max(500)).min(1).max(20)).describe("For raw-json: exact JSON Pointer paths to inspect. Empty means omitted."),
+	paths: optionalArrayInput(z.array(z.string().min(1).max(500)).min(1).max(MAX_RAW_JSON_PATHS_PER_REQUEST)).describe(`For raw-json: exact JSON Pointer paths to inspect in request order. itemRef takes precedence when both are supplied. Up to ${MAX_RAW_JSON_PATHS_PER_RESULT} paths are returned per call; larger valid requests receive explicit coverage and retry guidance instead of failing input validation. Empty means omitted.`),
 	includeChildren: optionalInput(z.boolean()).describe("For item-details: include direct survey-tree children."),
 	includeItemConfig: optionalInput(z.boolean()).describe("For item-details: include choice/form/internal item config details."),
 	limit: optionalInput(z.number().int().min(1).max(50)).describe("Maximum list rows to return.")
@@ -1636,6 +1736,89 @@ const stringifyForModel = (value) => {
 	if (typeof value === "string") return value;
 	return JSON.stringify(value, null, 2);
 };
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const MAX_LOCALIZATION_TEXT_CHARS = 2e3;
+const SURVEY_TRANSLATION_SURFACES = [
+	"surveyCardContent",
+	"navigationContent",
+	"validationMessages"
+];
+const truncateLocalizationText = (content) => {
+	const text = getContentPlainText(content).trim();
+	return text.length > MAX_LOCALIZATION_TEXT_CHARS ? `${text.slice(0, MAX_LOCALIZATION_TEXT_CHARS)}...` : text;
+};
+const listLocalizationSurfaces = (input, snapshot, targetLocale) => {
+	const survey = snapshot.survey;
+	const sourceLocale = input.sourceLocale ?? snapshot.ui.selectedLocale;
+	const sourceTranslations = survey.translations?.[sourceLocale];
+	const targetTranslations = survey.translations?.[targetLocale];
+	if (!sourceTranslations) return {
+		ok: false,
+		reason: `Source locale "${sourceLocale}" is not present in the current survey draft.`
+	};
+	const surfaces = [];
+	const addSurface = ({ contentKey, itemId, itemKey, itemType, sourceContent, surface, targetContent }) => {
+		const sourceText = truncateLocalizationText(sourceContent);
+		if (!sourceText) return;
+		surfaces.push({
+			scope: itemId ? "item" : "survey",
+			...surface ? { surface } : {},
+			...itemId ? {
+				itemId,
+				itemKey,
+				itemType
+			} : {},
+			contentKey,
+			sourceType: sourceContent.type,
+			sourceText,
+			...sourceContent.type === "richText" ? { sourceContent } : {},
+			targetPresent: Boolean(targetContent && truncateLocalizationText(targetContent)),
+			...targetContent ? {
+				targetType: targetContent.type,
+				targetText: truncateLocalizationText(targetContent)
+			} : {}
+		});
+	};
+	for (const surface of SURVEY_TRANSLATION_SURFACES) {
+		const targetSurface = targetTranslations?.[surface];
+		for (const [contentKey, sourceContent] of Object.entries(sourceTranslations[surface] ?? {})) addSurface({
+			surface,
+			contentKey,
+			sourceContent,
+			targetContent: targetSurface?.[contentKey]
+		});
+	}
+	for (const item of survey.surveyItems) for (const [contentKey, sourceContent] of Object.entries(sourceTranslations.itemTranslations?.[item.id] ?? {})) addSurface({
+		itemId: item.id,
+		itemKey: item.key,
+		itemType: item.itemType,
+		contentKey,
+		sourceContent,
+		targetContent: targetTranslations?.itemTranslations?.[item.id]?.[contentKey]
+	});
+	const missingCount = surfaces.filter((surface) => !surface.targetPresent).length;
+	const filteredSurfaces = input.missingOnly ? surfaces.filter((surface) => !surface.targetPresent) : surfaces;
+	const parsedCursor = Number.parseInt(input.cursor ?? "0", 10);
+	const offset = Number.isFinite(parsedCursor) && parsedCursor >= 0 ? parsedCursor : 0;
+	const limit = input.limit ?? 20;
+	const page = filteredSurfaces.slice(offset, offset + limit);
+	const nextOffset = offset + page.length;
+	return {
+		ok: true,
+		result: {
+			sourceLocale,
+			targetLocale,
+			missingOnly: input.missingOnly ?? false,
+			totalSourceSurfaces: surfaces.length,
+			totalAvailable: filteredSurfaces.length,
+			missingCount,
+			returned: page.length,
+			...nextOffset < filteredSurfaces.length ? { nextCursor: String(nextOffset) } : {},
+			listOrdering: { surfaces: "Survey-level translation surfaces first, then item translations in stored survey-item and source content-key order. Cursor pagination preserves this order only while the draft is unchanged; restart without a cursor after mutations." },
+			surfaces: page
+		}
+	};
+};
 const resolveItemRef = (input, snapshot) => {
 	if (input.itemRef && input.itemRef !== "selected") return input.itemRef;
 	return snapshot?.ui.selectedItemId;
@@ -1717,7 +1900,7 @@ const listAssets = (input, snapshot) => {
 };
 const surveyInspectTool = createTool({
 	id: TOOL_ID$3,
-	description: "Inspect the current request-scoped survey draft through one compact interface: current context, item search, item details, image assets with explicit asset IDs and usages, or focused raw JSON. At turn start the draft equals the live snapshot; successful same-turn edits appear immediately.",
+	description: "Inspect the current request-scoped survey draft through one compact interface: current context, item search, item details, paged source/target localization surfaces, image assets with explicit asset IDs and usages, or focused raw JSON. At turn start the draft equals the live snapshot; successful same-turn edits appear immediately.",
 	inputSchema: inputSchema$3,
 	outputSchema: outputSchema$2,
 	mcp: { annotations: {
@@ -1792,6 +1975,27 @@ const surveyInspectTool = createTool({
 				result
 			};
 		}
+		if (input.action === "localization") {
+			if (!input.targetLocale) return {
+				ok: false,
+				action: input.action,
+				reason: "Localization inspection requires a targetLocale.",
+				modelSummary: "Localization inspection requires a targetLocale."
+			};
+			const localization = listLocalizationSurfaces(input, snapshot, input.targetLocale);
+			if (!localization.ok) return {
+				ok: false,
+				action: input.action,
+				reason: localization.reason,
+				modelSummary: localization.reason
+			};
+			return {
+				ok: true,
+				action: input.action,
+				modelSummary: stringifyForModel(localization.result),
+				result: localization.result
+			};
+		}
 		if (input.action === "assets") {
 			const result = listAssets(input, snapshot);
 			return {
@@ -1801,16 +2005,34 @@ const surveyInspectTool = createTool({
 				result
 			};
 		}
-		const itemId = resolveItemRef(input, snapshot);
+		const itemId = input.itemRef ? resolveItemRef(input, snapshot) : void 0;
 		const itemIdentifiers = itemId ? [itemId] : void 0;
-		const result = unwrapToolOutput(await runTool(surveyGetRawSurveyTool, {
-			paths: input.paths,
+		const requestedPaths = itemIdentifiers ? void 0 : input.paths;
+		const boundedPaths = requestedPaths?.slice(0, MAX_RAW_JSON_PATHS_PER_RESULT);
+		const rawResult = unwrapToolOutput(await runTool(surveyGetRawSurveyTool, {
+			paths: boundedPaths,
 			itemIdentifiers
 		}, context));
+		const ignoredPathCount = itemIdentifiers ? input.paths?.length ?? 0 : 0;
+		const omittedPathCount = Math.max(0, (requestedPaths?.length ?? 0) - (boundedPaths?.length ?? 0));
+		const requestCoverage = ignoredPathCount > 0 || omittedPathCount > 0 ? {
+			precedence: itemIdentifiers ? "itemRef was resolved and inspected; explicit paths were ignored." : "Explicit paths were inspected in request order.",
+			requestedPathCount: input.paths?.length ?? 0,
+			inspectedPathCount: boundedPaths?.length ?? 0,
+			ignoredPathCount,
+			omittedPathCount,
+			...omittedPathCount > 0 ? { nextPaths: requestedPaths?.slice(MAX_RAW_JSON_PATHS_PER_RESULT, MAX_RAW_JSON_PATHS_PER_RESULT * 2) } : {},
+			recovery: itemIdentifiers ? "Use a separate raw-json call without itemRef if the explicit paths are still needed." : "Retry the returned nextPaths in a separate raw-json call if they are still needed."
+		} : void 0;
+		const result = requestCoverage && isRecord(rawResult) ? {
+			...rawResult,
+			requestCoverage
+		} : rawResult;
+		const modelSummary = [requestCoverage ? `Raw JSON request normalized instead of rejected: ${JSON.stringify(requestCoverage)}` : void 0, stringifyForModel(result)].filter((value) => Boolean(value)).join("\n");
 		return {
 			ok: true,
 			action: input.action,
-			modelSummary: stringifyForModel(result),
+			modelSummary,
 			result
 		};
 	},
@@ -1821,13 +2043,31 @@ const surveyInspectTool = createTool({
 const TOOL_ID$2 = "survey_attachment";
 const surveyAttachmentTool = createTool({
 	id: TOOL_ID$2,
-	description: "Attach only the stored PDFs or images needed for the current task to the next native model request. After this succeeds, read the original files directly and continue the task.",
-	inputSchema: z.object({ documentIds: z.array(z.string().min(1)).min(1).max(4).describe("IDs of only the stored attachments needed for the current request.") }),
-	outputSchema: z.object({ loaded: z.array(z.object({
-		id: z.string(),
-		filename: z.string(),
-		mediaType: z.string()
-	})) }),
+	description: "Attach only the stored PDFs or images needed for the current task to the next native model request. For source continuation, use this before conversational recall and provide a page or section focus when known. The original file remains authoritative.",
+	inputSchema: z.object({
+		documentIds: z.array(z.string().min(1)).min(1).max(4).optional().describe("Stored attachment IDs to load completely when no page/section focus is needed."),
+		documentRequests: z.array(z.object({
+			documentId: z.string().min(1),
+			pages: z.object({
+				start: z.number().int().min(1).max(1e5),
+				end: z.number().int().min(1).max(1e5)
+			}).optional().describe("One-based inclusive PDF page range to prioritize."),
+			focus: z.string().min(1).max(300).optional().describe("Short section, question range, or fact to prioritize in the original file.")
+		})).min(1).max(4).optional().describe("Stored attachments with an optional bounded reading focus.")
+	}),
+	outputSchema: z.object({
+		loaded: z.array(z.object({
+			id: z.string(),
+			filename: z.string(),
+			mediaType: z.string(),
+			pages: z.object({
+				start: z.number().int(),
+				end: z.number().int()
+			}).optional(),
+			focus: z.string().optional()
+		})),
+		warnings: z.array(z.string()).optional()
+	}),
 	mcp: { annotations: {
 		title: "Load chat attachment",
 		readOnlyHint: true,
@@ -1838,35 +2078,121 @@ const surveyAttachmentTool = createTool({
 	execute: async (inputData, context) => {
 		const access = (context?.requestContext)?.get("attachmentAccess");
 		if (!access) return { loaded: [] };
-		const requestedIds = [...new Set(inputData.documentIds)];
+		const warnings = [];
+		const requests = /* @__PURE__ */ new Map();
+		for (const documentId of inputData.documentIds ?? []) requests.set(documentId, {});
+		for (const request of inputData.documentRequests ?? []) {
+			if (request.pages && request.pages.end < request.pages.start) {
+				warnings.push(`Ignored invalid page range ${request.pages.start}-${request.pages.end} for ${request.documentId}.`);
+				requests.set(request.documentId, { ...request.focus ? { focus: request.focus } : {} });
+				continue;
+			}
+			requests.set(request.documentId, {
+				...request.pages ? { pages: request.pages } : {},
+				...request.focus ? { focus: request.focus } : {}
+			});
+		}
+		const requestedIds = [...requests.keys()];
 		const authorized = access.documents.filter((document) => requestedIds.includes(document.id));
 		const attachments = await access.load(authorized.map((document) => document.id));
 		access.selectedAttachments.splice(0, access.selectedAttachments.length, ...attachments);
-		return { loaded: authorized.map((document) => ({
-			id: document.id,
-			filename: document.name,
-			mediaType: document.mediaType
-		})) };
+		return {
+			loaded: authorized.map((document) => {
+				const request = requests.get(document.id);
+				const pages = document.mediaType === "application/pdf" ? request?.pages : void 0;
+				if (request?.pages && !pages) warnings.push(`Ignored a PDF page focus for non-PDF attachment ${document.name}.`);
+				return {
+					id: document.id,
+					filename: document.name,
+					mediaType: document.mediaType,
+					...pages ? { pages } : {},
+					...request?.focus ? { focus: request.focus } : {}
+				};
+			}),
+			...warnings.length > 0 ? { warnings } : {}
+		};
 	},
-	toModelOutput: (value) => toTextModelOutput(value, () => "The selected original attachments are included in this model input. Read them directly now and continue the user's task. Do not claim that their content is unavailable or ask the user to paste extracted text.")
+	toModelOutput: (value) => toTextModelOutput(value, (output) => {
+		if (output.loaded.length === 0) return [
+			"No authorized stored attachment was loaded. Do not infer source content from conversation memory.",
+			...(output.warnings ?? []).map((warning) => `Warning: ${warning}`),
+			"Inspect the available attachment ids and retry with only the source documents needed for this task."
+		].join("\n");
+		const focuses = output.loaded.map((document) => {
+			const details = [document.pages ? `prioritize one-based pages ${document.pages.start}-${document.pages.end}` : void 0, document.focus ? `focus: ${document.focus}` : void 0].filter(Boolean);
+			return details.length > 0 ? `- ${document.filename}: ${details.join("; ")}` : void 0;
+		}).filter((line) => Boolean(line));
+		return [
+			"The selected complete original attachments are included in this model input. Read them directly now and continue the user's task. Conversation memory is not a lossless source.",
+			focuses.length > 0 ? `Requested reading focus (the complete original remains authoritative):\n${focuses.join("\n")}` : void 0,
+			...(output.warnings ?? []).map((warning) => `Warning: ${warning}`),
+			"Do not claim that successfully loaded content is unavailable or ask the user to paste extracted text."
+		].filter((line) => Boolean(line)).join("\n");
+	})
 });
 //#endregion
 //#region src/server/tools/survey-audit-tool.ts
 const TOOL_ID$1 = "survey_audit";
+const inputSchema$1 = z.object({
+	sourceLocale: z.string().min(1).optional().describe("Locale treated as the source when checking translation completeness."),
+	targetLocales: z.array(z.string().min(1)).max(20).optional(),
+	maxFindings: z.number().int().min(1).max(300).default(120).optional(),
+	reason: z.string().max(500).optional()
+});
+const outputSchema = z.object({
+	ok: z.boolean(),
+	reason: z.string().optional(),
+	report: z.unknown().optional()
+});
+const MAX_AUDIT_MODEL_GROUPS = 16;
+const MAX_AUDIT_MODEL_EXAMPLES = 12;
+const MAX_AUDIT_MESSAGE_CHARACTERS = 300;
+const previewAuditMessage = (message) => {
+	const characters = [...message];
+	if (characters.length <= MAX_AUDIT_MESSAGE_CHARACTERS) return message;
+	return `${characters.slice(0, MAX_AUDIT_MESSAGE_CHARACTERS).join("")}… [${characters.length} characters total]`;
+};
+const formatAuditForModel = (output) => {
+	if (!output.ok || !output.report || typeof output.report !== "object") return output.reason ?? "The deterministic survey audit could not be completed.";
+	const report = output.report;
+	const groups = /* @__PURE__ */ new Map();
+	for (const finding of report.findings) {
+		const key = `${finding.severity}\u0000${finding.category}\u0000${finding.code}`;
+		const group = groups.get(key) ?? {
+			category: finding.category,
+			code: finding.code,
+			count: 0,
+			severity: finding.severity
+		};
+		group.count += 1;
+		groups.set(key, group);
+	}
+	const groupedFindings = [...groups.values()].sort((left, right) => right.count - left.count || left.severity.localeCompare(right.severity) || left.code.localeCompare(right.code));
+	const shownGroups = groupedFindings.slice(0, MAX_AUDIT_MODEL_GROUPS);
+	const examples = report.findings.slice(0, MAX_AUDIT_MODEL_EXAMPLES);
+	return [
+		`Deterministic survey audit: ${report.findingCount} finding${report.findingCount === 1 ? "" : "s"} (errors=${report.summary.error}, warnings=${report.summary.warning}, info=${report.summary.info}).`,
+		`Finding coverage returned by the audit: ${report.findings.length}/${report.findingCount}${report.truncated ? " (bounded)" : ""}.`,
+		`Metrics: ${JSON.stringify(report.metrics)}.`,
+		shownGroups.length > 0 ? `Finding groups (${shownGroups.length}/${groupedFindings.length} shown):\n${shownGroups.map((group) => `- ${group.severity}/${group.category}/${group.code}: ${group.count} returned finding${group.count === 1 ? "" : "s"}`).join("\n")}` : "Finding groups: none.",
+		examples.length > 0 ? `Ordered examples (${examples.length}/${report.findings.length} returned findings shown):\n${examples.map((finding) => {
+			const location = [
+				finding.itemId,
+				finding.locale,
+				finding.contentKey
+			].filter(Boolean).join(":");
+			return `- ${finding.code}${location ? ` (${location})` : ""}: ${previewAuditMessage(finding.message)}`;
+		}).join("\n")}` : void 0,
+		report.qualityReviewPrinciples.length > 0 ? `Qualitative review rubric:\n${report.qualityReviewPrinciples.map((principle) => `- ${principle.id}: ${principle.prompt}`).join("\n")}` : void 0,
+		report.note,
+		"This audit checks the current survey deterministically. It does not compare the draft with an attached source document, so a clean audit does not establish source fidelity or completeness."
+	].filter((line) => Boolean(line)).join("\n\n");
+};
 const surveyAuditTool = createTool({
 	id: TOOL_ID$1,
 	description: "Audit the current survey for deterministic structural, content, localization, response, and asset issues, and return a research-informed questionnaire-quality review rubric for qualitative critique. This is read-only and is not psychometric validation.",
-	inputSchema: z.object({
-		sourceLocale: z.string().min(1).optional().describe("Locale treated as the source when checking translation completeness."),
-		targetLocales: z.array(z.string().min(1)).max(20).optional(),
-		maxFindings: z.number().int().min(1).max(300).default(120).optional(),
-		reason: z.string().max(500).optional()
-	}),
-	outputSchema: z.object({
-		ok: z.boolean(),
-		reason: z.string().optional(),
-		report: z.unknown().optional()
-	}),
+	inputSchema: inputSchema$1,
+	outputSchema,
 	mcp: { annotations: {
 		title: "Audit survey",
 		readOnlyHint: true,
@@ -1885,7 +2211,7 @@ const surveyAuditTool = createTool({
 			report: auditSurvey(snapshot, input)
 		};
 	},
-	toModelOutput: (value) => toTextModelOutput(value, (output) => JSON.stringify(output, null, 2))
+	toModelOutput: (value) => toTextModelOutput(value, formatAuditForModel)
 });
 //#endregion
 //#region src/server/tools/survey-asset-tool.ts
@@ -2089,4 +2415,4 @@ const surveyAssistantTools = Object.freeze({
 //#endregion
 export { surveyAuditTool as i, surveyAssistantTools as n, surveyAssetTool as r, SURVEY_ASSISTANT_TOOL_IDS as t };
 
-//# sourceMappingURL=tools-wgLen05n.mjs.map
+//# sourceMappingURL=tools-Dg9HZrYU.mjs.map