@case-framework/survey-assistant 0.1.0 → 0.2.0

package/dist/{react-VuYe-cPh.mjs → react-B_5smfiK.mjs}

@@ -1,5 +1,5 @@
-import { A as surveyAssistantThreadTranscriptSchema, O as surveyAssistantThreadListSchema, c as surveyAssistantTurnFinalSchema, d as surveyAssistantModelCatalogSchema, k as surveyAssistantThreadSchema, n as SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE, r as applyReceiptSchema, u as surveyChangeSetSchema } from "./protocol-DV0ka9WT.mjs";
-import { o as readSurveyAssistantJson } from "./controller-proxy-Duxo2IFE.mjs";
+import { A as surveyAssistantThreadSchema, B as surveyDocumentVersionSchema, c as surveyAssistantTurnFinalSchema, d as surveyAssistantModelCatalogSchema, j as surveyAssistantThreadTranscriptSchema, k as surveyAssistantThreadListSchema, n as SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE, r as applyReceiptSchema, u as surveyChangeSetSchema } from "./protocol-7EEgcYja.mjs";
+import { a as applySurveyAssistantLaunchUIContext, l as readSurveyAssistantJson } from "./controller-proxy-ClsY4lFI.mjs";
 import { DefaultChatTransport } from "ai";
 import { useCallback, useEffect, useEffectEvent, useMemo, useReducer, useRef, useState } from "react";
 import { useChat } from "@ai-sdk/react";
@@ -143,10 +143,11 @@ const createApplyReceipts = ({ afterSnapshot, beforeSnapshot, changeSets, result
 const findLastUserMessage = (messages) => {
 	for (let index = messages.length - 1; index >= 0; index -= 1) if (messages[index]?.role === "user") return messages[index];
 };
-const createSurveyAssistantTransport = ({ api = "/api/survey-assistant/chat", resourceId, threadId }) => new DefaultChatTransport({
+const createSurveyAssistantTransport = ({ api = "/api/survey-assistant/chat", resourceId, surveyId, threadId }) => new DefaultChatTransport({
 	api,
 	body: {
 		resourceId,
+		...surveyId ? { surveyId } : {},
 		threadId
 	},
 	prepareSendMessagesRequest: ({ api, body, credentials, headers, id, messageId, messages, trigger }) => {
@@ -271,6 +272,42 @@ const useSurveyAssistantModelCatalog = ({ api, client: providedClient, onModelCh
 	};
 };
 //#endregion
+//#region src/react/document-baseline.ts
+const STORAGE_PREFIX = "case-survey-assistant:settled-document:";
+const memoryBaselines = /* @__PURE__ */ new Map();
+const getStorageKey = (resourceId, threadId) => `${STORAGE_PREFIX}${encodeURIComponent(resourceId)}:${encodeURIComponent(threadId)}`;
+const getSessionStorage = () => {
+	if (typeof document === "undefined") return void 0;
+	try {
+		return window.sessionStorage;
+	} catch {
+		return;
+	}
+};
+const readSettledDocumentVersion = ({ resourceId, threadId }) => {
+	const storageKey = getStorageKey(resourceId, threadId);
+	const storedInMemory = memoryBaselines.get(storageKey);
+	if (storedInMemory) return { ...storedInMemory };
+	const serialized = getSessionStorage()?.getItem(storageKey);
+	if (!serialized) return void 0;
+	try {
+		const parsed = surveyDocumentVersionSchema.safeParse(JSON.parse(serialized));
+		if (!parsed.success) return void 0;
+		memoryBaselines.set(storageKey, parsed.data);
+		return { ...parsed.data };
+	} catch {
+		return;
+	}
+};
+const writeSettledDocumentVersion = ({ resourceId, snapshot, threadId }) => {
+	const storageKey = getStorageKey(resourceId, threadId);
+	const version = surveyDocumentVersionSchema.parse(snapshot.version);
+	memoryBaselines.set(storageKey, version);
+	try {
+		getSessionStorage()?.setItem(storageKey, JSON.stringify(version));
+	} catch {}
+};
+//#endregion
 //#region src/react/use-survey-assistant-session.ts
 const createLocalId = (prefix) => {
 	return `${prefix}-${globalThis.crypto?.randomUUID?.() ?? Math.random().toString(36).slice(2)}`;
@@ -301,7 +338,11 @@ const collectChangeSetsAfterLastUser = (messages) => {
 	const lastUserIndex = findLastUserMessageIndex(messages);
 	return lastUserIndex < 0 ? [] : collectSurveyChangeSets(messages.slice(lastUserIndex + 1));
 };
-const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, initialMessages = [], modelId, onApplyReceipts, onReviewChangeSets, onTurnActiveChange, resourceId: controlledResourceId, threadId: controlledThreadId }) => {
+const resolveSurveyAssistantReviewDecision = async ({ changeSets, onReviewChangeSets, turnFinal }) => {
+	if (!onReviewChangeSets) throw new Error("No survey assistant review adapter is available.");
+	return onReviewChangeSets(changeSets, turnFinal);
+};
+const useSurveyAssistantSession = ({ api, applyPolicy, controller, initialMessages = [], modelId, onApplyReceipts, onSettleApply, onReviewChangeSets, onTurnActiveChange, resourceId: controlledResourceId, surveyId, threadId: controlledThreadId }) => {
 	const [localResourceId] = useState(() => createLocalId("survey-assistant-local-user"));
 	const [localThreadId] = useState(() => createLocalId("survey-assistant-local-thread"));
 	const resourceId = controlledResourceId ?? localResourceId;
@@ -312,16 +353,20 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 	const handledTurnIdsRef = useRef(/* @__PURE__ */ new Set());
 	const localTurnAwaitingApplyRef = useRef(false);
 	const localTurnStreamStartedRef = useRef(false);
+	const captureSettledVersionRef = useRef(false);
+	const lastSubmittedUIContextRef = useRef(void 0);
 	const { messages, setMessages, sendMessage, status, stop: stopChat, error, clearError, regenerate } = useChat({
 		id: threadId,
 		messages: initialMessages,
 		transport: useMemo(() => createSurveyAssistantTransport({
 			api,
 			resourceId,
+			surveyId,
 			threadId
 		}), [
 			api,
 			resourceId,
+			surveyId,
 			threadId
 		])
 	});
@@ -355,6 +400,22 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 			if (isTurnActive) notifyTurnActiveChange(false);
 		};
 	}, [isTurnActive]);
+	useEffect(() => {
+		if (!captureSettledVersionRef.current || isStreaming || state !== "completed" && state !== "failed" && state !== "aborted" && state !== "applied") return;
+		captureSettledVersionRef.current = false;
+		const snapshot = controller?.getSnapshot();
+		if (snapshot) writeSettledDocumentVersion({
+			resourceId,
+			snapshot,
+			threadId
+		});
+	}, [
+		controller,
+		isStreaming,
+		resourceId,
+		state,
+		threadId
+	]);
 	useEffect(() => {
 		if (isStreaming) {
 			localTurnStreamStartedRef.current = true;
@@ -387,41 +448,69 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 			dispatch({ type: "completed" });
 			return;
 		}
-		if (applyPolicy === "review") {
-			onReviewChangeSets?.(turnAuthorization.changeSets, turnFinal);
-			dispatch({ type: "completed" });
-			return;
-		}
-		if (!controller?.applyAssistantChange && !controller?.applyAssistantChanges) {
-			reportAuthorizationError("No survey editor apply adapter is available.");
-			return;
-		}
-		const beforeSnapshot = controller.getSnapshot();
-		if (!beforeSnapshot) {
-			reportAuthorizationError("The editor state was unavailable when applying the assistant change.");
-			return;
-		}
 		dispatch({ type: "apply-started" });
-		const result = controller.applyAssistantChanges?.(turnAuthorization.changeSets) ?? { results: turnAuthorization.changeSets.map((change) => controller.applyAssistantChange?.(change)).filter((applyResult) => Boolean(applyResult)) };
-		queueMicrotask(() => setApplyResultsByChangeId((current) => ({
-			...current,
-			...Object.fromEntries(result.results.map((applyResult) => [applyResult.changeId, applyResult]))
-		})));
-		const receipts = createApplyReceipts({
-			beforeSnapshot,
-			afterSnapshot: controller.getSnapshot(),
-			changeSets: turnAuthorization.changeSets,
-			results: result.results,
-			turnFinal
-		});
-		onApplyReceipts?.(receipts);
-		dispatch({ type: result.results.every((applyResult) => applyResult.status === "applied") ? "applied" : "completed" });
+		(async () => {
+			if (applyPolicy === "review") {
+				let approved;
+				try {
+					approved = await resolveSurveyAssistantReviewDecision({
+						changeSets: turnAuthorization.changeSets,
+						onReviewChangeSets,
+						turnFinal
+					});
+				} catch (error) {
+					reportAuthorizationError(error instanceof Error && error.message === "No survey assistant review adapter is available." ? error.message : "The survey assistant review could not be completed.");
+					return;
+				}
+				if (!approved) {
+					dispatch({ type: "completed" });
+					return;
+				}
+			}
+			if (!controller?.applyAssistantChange && !controller?.applyAssistantChanges) {
+				reportAuthorizationError("No survey editor apply adapter is available.");
+				return;
+			}
+			const beforeSnapshot = controller.getSnapshot();
+			if (!beforeSnapshot) {
+				reportAuthorizationError("The editor state was unavailable when applying the assistant change.");
+				return;
+			}
+			const result = controller.applyAssistantChanges?.(turnAuthorization.changeSets) ?? { results: turnAuthorization.changeSets.map((change) => controller.applyAssistantChange?.(change)).filter((applyResult) => Boolean(applyResult)) };
+			queueMicrotask(() => setApplyResultsByChangeId((current) => ({
+				...current,
+				...Object.fromEntries(result.results.map((applyResult) => [applyResult.changeId, applyResult]))
+			})));
+			const receipts = createApplyReceipts({
+				beforeSnapshot,
+				afterSnapshot: controller.getSnapshot(),
+				changeSets: turnAuthorization.changeSets,
+				results: result.results,
+				turnFinal
+			});
+			onApplyReceipts?.(receipts);
+			if (!result.results.every((applyResult) => applyResult.status === "applied")) {
+				dispatch({ type: "completed" });
+				return;
+			}
+			try {
+				await onSettleApply?.({
+					changeSets: turnAuthorization.changeSets,
+					receipts,
+					turnFinal
+				});
+				dispatch({ type: "applied" });
+			} catch {
+				reportAuthorizationError("The assistant changes were applied locally but could not be settled by the host.");
+			}
+		})();
 	}, [
 		applyPolicy,
 		controller,
 		isStreaming,
 		onApplyReceipts,
 		onReviewChangeSets,
+		onSettleApply,
 		reportAuthorizationError,
 		turnAuthorization
 	]);
@@ -436,7 +525,7 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 		hasUsefulLatestAssistantResponse,
 		setMessages
 	]);
-	const submit = useCallback(({ files, text: rawText }) => {
+	const submit = useCallback(({ files, text: rawText, uiContext }) => {
 		const text = rawText.trim();
 		if (!text && files.length === 0) return false;
 		if (isStreaming || localTurnAwaitingApplyRef.current) return false;
@@ -446,11 +535,18 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 		if (authorizationError || error) setMessages(pruneFailedMessagesForDisplay);
 		clearError();
 		dispatch({ type: "submit" });
+		captureSettledVersionRef.current = true;
+		lastSubmittedUIContextRef.current = uiContext;
+		const snapshot = applySurveyAssistantLaunchUIContext(controller?.getSnapshot() ?? null, uiContext);
 		sendMessage(files.length > 0 ? text ? {
 			text,
 			files
 		} : { files } : { text }, { body: {
-			snapshot: controller?.getSnapshot() ?? null,
+			snapshot,
+			previousSettledVersion: readSettledDocumentVersion({
+				resourceId,
+				threadId
+			}),
 			...modelId ? { modelId } : {}
 		} });
 		return true;
@@ -461,8 +557,10 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 		error,
 		isStreaming,
 		modelId,
+		resourceId,
 		sendMessage,
-		setMessages
+		setMessages,
+		threadId
 	]);
 	const stop = useCallback(() => {
 		localTurnAwaitingApplyRef.current = false;
@@ -476,15 +574,24 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 		setAuthorizationError(null);
 		clearError();
 		dispatch({ type: "submit" });
+		captureSettledVersionRef.current = true;
+		const controllerSnapshot = controller?.getSnapshot() ?? null;
+		const uiContext = lastSubmittedUIContextRef.current;
 		regenerate({ body: {
-			snapshot: controller?.getSnapshot() ?? null,
+			snapshot: applySurveyAssistantLaunchUIContext(controllerSnapshot, uiContext),
+			previousSettledVersion: readSettledDocumentVersion({
+				resourceId,
+				threadId
+			}),
 			...modelId ? { modelId } : {}
 		} });
 	}, [
 		clearError,
 		controller,
 		modelId,
-		regenerate
+		regenerate,
+		resourceId,
+		threadId
 	]);
 	return {
 		applyResultsByChangeId,
@@ -518,4 +625,4 @@ const useSurveyAssistantSession = ({ api, applyPolicy = "auto", controller, init
 //#endregion
 export { createSurveyAssistantTransport as a, getSurveyDocumentVersionFromSnapshot as c, resolveSurveyTurnOutcome as d, unwrapSurveyAssistantToolOutput as f, createSurveyAssistantThreadClient as i, parseSurveyChangeSet as l, reduceSurveyAssistantSessionState as m, createSurveyAssistantModelCatalogClient as n, collectSurveyChangeSets as o, isSurveyAssistantTurnActive as p, useSurveyAssistantModelCatalog as r, createApplyReceipts as s, useSurveyAssistantSession as t, resolveLatestSurveyTurnAuthorization as u };
 
-//# sourceMappingURL=react-VuYe-cPh.mjs.map
+//# sourceMappingURL=react-B_5smfiK.mjs.map

package/dist/react-B_5smfiK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-B_5smfiK.mjs","names":["findLastUserMessageIndex"],"sources":["../src/react/session-state.ts","../src/react/turn-authorization.ts","../src/react/transport.ts","../src/react/thread-client.ts","../src/react/model-catalog.ts","../src/react/document-baseline.ts","../src/react/use-survey-assistant-session.ts"],"sourcesContent":["export type SurveyAssistantSessionState =\n  | \"idle\"\n  | \"submitting\"\n  | \"streaming\"\n  | \"completed\"\n  | \"failed\"\n  | \"aborted\"\n  | \"applying\"\n  | \"applied\";\n\nexport type SurveyAssistantSessionEvent =\n  | { type: \"submit\" }\n  | { type: \"stream-started\" }\n  | { type: \"completed\" }\n  | { type: \"apply-started\" }\n  | { type: \"applied\" }\n  | { type: \"failed\" }\n  | { type: \"aborted\" }\n  | { type: \"reset\"; hasTranscript: boolean };\n\nexport const isSurveyAssistantTurnActive = ({\n  isStreaming,\n  state,\n}: {\n  isStreaming: boolean;\n  state: SurveyAssistantSessionState;\n}): boolean =>\n  state !== \"aborted\" &&\n  (isStreaming || state === \"submitting\" || state === \"streaming\" || state === \"applying\");\n\nexport const reduceSurveyAssistantSessionState = (\n  _state: SurveyAssistantSessionState,\n  event: SurveyAssistantSessionEvent,\n): SurveyAssistantSessionState => {\n  switch (event.type) {\n    case \"submit\":\n      return \"submitting\";\n    case \"stream-started\":\n      return \"streaming\";\n    case \"completed\":\n      return \"completed\";\n    case \"apply-started\":\n      return \"applying\";\n    case \"applied\":\n      return \"applied\";\n    case \"failed\":\n      return \"failed\";\n    case \"aborted\":\n      return \"aborted\";\n    case \"reset\":\n      return event.hasTranscript ? \"completed\" : \"idle\";\n  }\n};\n","import {\n  SURVEY_ASSISTANT_PROTOCOL_VERSION,\n  SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE,\n  applyReceiptSchema,\n  surveyAssistantTurnFinalSchema,\n  surveyChangeSetSchema,\n  type ApplyReceipt,\n  type SurveyAssistantSnapshot,\n  type SurveyAssistantTurnFinal,\n  type SurveyApplyResult,\n  type SurveyChangeSet,\n  type SurveyDocumentVersion,\n} from \"../protocol\";\nimport type { UIMessage } from \"ai\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isCompletedToolPart = (\n  part: UIMessage[\"parts\"][number],\n): part is UIMessage[\"parts\"][number] & { state: \"output-available\"; output: unknown } =>\n  (part.type === \"dynamic-tool\" || part.type.startsWith(\"tool-\")) &&\n  \"state\" in part &&\n  part.state === \"output-available\" &&\n  \"output\" in part;\n\nexport const unwrapSurveyAssistantToolOutput = (output: unknown) => {\n  if (isRecord(output) && \"output\" in output && output.output !== undefined) {\n    return output.output;\n  }\n  return output;\n};\n\nexport const parseSurveyChangeSet = (output: unknown): SurveyChangeSet | null => {\n  const parsed = surveyChangeSetSchema.safeParse(unwrapSurveyAssistantToolOutput(output));\n  return parsed.success ? parsed.data : null;\n};\n\nexport const collectSurveyChangeSets = (messages: UIMessage[]): SurveyChangeSet[] => {\n  const changes: SurveyChangeSet[] = [];\n  for (const message of messages) {\n    for (const part of message.parts) {\n      if (!isCompletedToolPart(part)) {\n        continue;\n      }\n      const change = parseSurveyChangeSet(part.output);\n      if (change) {\n        changes.push(change);\n      }\n    }\n  }\n  return changes;\n};\n\nconst findLastUserMessageIndex = (messages: UIMessage[]) => {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.role === \"user\") return index;\n  }\n  return -1;\n};\n\nexport type SurveyTurnAuthorization =\n  | { status: \"pending\" }\n  | { status: \"invalid\"; reason: string; turnId?: string }\n  | {\n      status: \"failed\" | \"aborted\";\n      turnFinal: SurveyAssistantTurnFinal;\n      changeSets: [];\n    }\n  | {\n      status: \"completed\";\n      turnFinal: SurveyAssistantTurnFinal;\n      changeSets: SurveyChangeSet[];\n    };\n\nexport type SurveyTurnOutcome =\n  | {\n      status: \"blocked\";\n      blockedChangeSetCount: number;\n    }\n  | {\n      status: \"apply-failed\";\n      appliedChangeSetCount: number;\n      failedChangeSetCount: number;\n    };\n\nexport const resolveLatestSurveyTurnAuthorization = (\n  messages: UIMessage[],\n): SurveyTurnAuthorization => {\n  const lastUserIndex = findLastUserMessageIndex(messages);\n  if (lastUserIndex < 0) {\n    return { status: \"pending\" };\n  }\n\n  const turnMessages = messages.slice(lastUserIndex + 1);\n  const finalParts = turnMessages\n    .flatMap((message) => message.parts)\n    .filter((part) => part.type === SURVEY_ASSISTANT_TURN_FINAL_PART_TYPE);\n  if (finalParts.length === 0) {\n    return { status: \"pending\" };\n  }\n  if (finalParts.length !== 1) {\n    return { status: \"invalid\", reason: \"The assistant returned multiple turn finals.\" };\n  }\n\n  const finalPart = finalParts[0];\n  const finalParse = surveyAssistantTurnFinalSchema.safeParse(\n    finalPart && \"data\" in finalPart ? finalPart.data : undefined,\n  );\n  if (!finalParse.success) {\n    return { status: \"invalid\", reason: \"The assistant returned an invalid turn final.\" };\n  }\n  const turnFinal = finalParse.data;\n  if (turnFinal.status !== \"completed\") {\n    return { status: turnFinal.status, turnFinal, changeSets: [] };\n  }\n\n  const candidates = collectSurveyChangeSets(turnMessages).filter(\n    (change) => change.turnId === turnFinal.turnId,\n  );\n  const candidatesById = new Map<string, SurveyChangeSet>();\n  for (const candidate of candidates) {\n    if (candidatesById.has(candidate.id)) {\n      return {\n        status: \"invalid\",\n        turnId: turnFinal.turnId,\n        reason: `The assistant returned duplicate change set \"${candidate.id}\".`,\n      };\n    }\n    candidatesById.set(candidate.id, candidate);\n  }\n\n  for (const blockedChangeSetId of turnFinal.blockedChangeSetIds ?? []) {\n    const candidate = candidatesById.get(blockedChangeSetId);\n    if (!candidate || candidate.status !== \"rejected\" || candidate.validation.valid) {\n      return {\n        status: \"invalid\",\n        turnId: turnFinal.turnId,\n        reason: `The assistant did not provide blocked change set \"${blockedChangeSetId}\".`,\n      };\n    }\n  }\n\n  const changeSets: SurveyChangeSet[] = [];\n  for (const changeSetId of turnFinal.executableChangeSetIds) {\n    const candidate = candidatesById.get(changeSetId);\n    if (!candidate || candidate.status !== \"validated\" || !candidate.validation.valid) {\n      return {\n        status: \"invalid\",\n        turnId: turnFinal.turnId,\n        reason: `The assistant did not provide authorized change set \"${changeSetId}\".`,\n      };\n    }\n    changeSets.push(candidate);\n  }\n\n  return { status: \"completed\", turnFinal, changeSets };\n};\n\nexport const resolveSurveyTurnOutcome = ({\n  applyResultsByChangeId,\n  authorization,\n}: {\n  applyResultsByChangeId: Record<string, SurveyApplyResult>;\n  authorization: SurveyTurnAuthorization;\n}): SurveyTurnOutcome | null => {\n  if (authorization.status !== \"completed\") {\n    return null;\n  }\n\n  const blockedChangeSetCount = authorization.turnFinal.blockedChangeSetIds?.length ?? 0;\n  if (blockedChangeSetCount > 0) {\n    return { status: \"blocked\", blockedChangeSetCount };\n  }\n\n  if (authorization.changeSets.length === 0) {\n    return null;\n  }\n\n  const results = authorization.changeSets.map((change) => applyResultsByChangeId[change.id]);\n  if (results.some((result) => result === undefined)) {\n    return null;\n  }\n\n  const failedChangeSetCount = results.filter((result) => result.status !== \"applied\").length;\n  if (failedChangeSetCount === 0) {\n    return null;\n  }\n\n  return {\n    status: \"apply-failed\",\n    appliedChangeSetCount: results.length - failedChangeSetCount,\n    failedChangeSetCount,\n  };\n};\n\nexport const getSurveyDocumentVersionFromSnapshot = (\n  snapshot: SurveyAssistantSnapshot,\n): SurveyDocumentVersion => ({ ...snapshot.version });\n\nexport const createApplyReceipts = ({\n  afterSnapshot,\n  beforeSnapshot,\n  changeSets,\n  results,\n  turnFinal,\n  createdAt = new Date().toISOString(),\n}: {\n  afterSnapshot: SurveyAssistantSnapshot | null;\n  beforeSnapshot: SurveyAssistantSnapshot;\n  changeSets: SurveyChangeSet[];\n  results: SurveyApplyResult[];\n  turnFinal: SurveyAssistantTurnFinal;\n  createdAt?: string;\n}): ApplyReceipt[] => {\n  const beforeVersion = getSurveyDocumentVersionFromSnapshot(beforeSnapshot);\n  const afterVersion = afterSnapshot\n    ? getSurveyDocumentVersionFromSnapshot(afterSnapshot)\n    : undefined;\n  const resultsByChangeId = new Map(results.map((result) => [result.changeId, result]));\n\n  return changeSets.map((changeSet) => {\n    const result = resultsByChangeId.get(changeSet.id);\n    const status = result?.status ?? \"failed\";\n    return applyReceiptSchema.parse({\n      protocolVersion: SURVEY_ASSISTANT_PROTOCOL_VERSION,\n      turnId: turnFinal.turnId,\n      changeSetId: changeSet.id,\n      beforeVersion,\n      ...(status === \"applied\" && afterVersion ? { afterVersion } : {}),\n      status,\n      operationCount: changeSet.operations.length,\n      ...(status === \"applied\" && afterVersion?.historyIndex !== undefined\n        ? { commit: { index: afterVersion.historyIndex } }\n        : {}),\n      ...(result?.issues ? { issues: result.issues } : {}),\n      createdAt,\n    });\n  });\n};\n","import { DefaultChatTransport, type UIMessage } from \"ai\";\n\nconst findLastUserMessage = (messages: UIMessage[]): UIMessage | undefined => {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.role === \"user\") return messages[index];\n  }\n  return undefined;\n};\n\nexport const createSurveyAssistantTransport = ({\n  api = \"/api/survey-assistant/chat\",\n  resourceId,\n  surveyId,\n  threadId,\n}: {\n  api?: string;\n  resourceId: string;\n  surveyId?: string;\n  threadId: string;\n}) =>\n  new DefaultChatTransport({\n    api,\n    body: { resourceId, ...(surveyId ? { surveyId } : {}), threadId },\n    prepareSendMessagesRequest: ({\n      api,\n      body,\n      credentials,\n      headers,\n      id,\n      messageId,\n      messages,\n      trigger,\n    }) => {\n      const latestUserMessage = findLastUserMessage(messages);\n      return {\n        api,\n        credentials,\n        headers,\n        body: {\n          ...body,\n          id,\n          messages: latestUserMessage ? [latestUserMessage] : [],\n          trigger,\n          messageId,\n        },\n      };\n    },\n  });\n","import {\n  surveyAssistantThreadListSchema,\n  surveyAssistantThreadSchema,\n  surveyAssistantThreadTranscriptSchema,\n  type SurveyAssistantThread,\n  type SurveyAssistantThreadTranscript,\n} from \"../protocol\";\nimport { readSurveyAssistantJson } from \"./client-error\";\n\nexport interface SurveyAssistantThreadClient {\n  delete(threadId: string): Promise<void>;\n  create(title?: string): Promise<SurveyAssistantThread>;\n  list(): Promise<SurveyAssistantThread[]>;\n  read(threadId: string): Promise<SurveyAssistantThreadTranscript>;\n  rename(threadId: string, title: string): Promise<SurveyAssistantThread>;\n  setAutomaticTitle(threadId: string, title?: string): Promise<SurveyAssistantThread>;\n}\n\nexport const createSurveyAssistantThreadClient = (\n  api = \"/api/survey-assistant/threads\",\n): SurveyAssistantThreadClient => ({\n  async delete(threadId) {\n    const response = await fetch(`${api}/${encodeURIComponent(threadId)}`, { method: \"DELETE\" });\n    if (!response.ok) await readSurveyAssistantJson(response);\n  },\n  async create(title) {\n    const body = await readSurveyAssistantJson(\n      await fetch(api, {\n        body: JSON.stringify(title ? { title } : {}),\n        headers: { \"content-type\": \"application/json\" },\n        method: \"POST\",\n      }),\n    );\n    return surveyAssistantThreadSchema.parse(body.thread);\n  },\n  async list() {\n    const body = await readSurveyAssistantJson(await fetch(api, { cache: \"no-store\" }));\n    return surveyAssistantThreadListSchema.parse(body).threads;\n  },\n  async read(threadId) {\n    const body = await readSurveyAssistantJson(\n      await fetch(`${api}/${encodeURIComponent(threadId)}`, { cache: \"no-store\" }),\n    );\n    return surveyAssistantThreadTranscriptSchema.parse(body);\n  },\n  async rename(threadId, title) {\n    const body = await readSurveyAssistantJson(\n      await fetch(`${api}/${encodeURIComponent(threadId)}`, {\n        body: JSON.stringify({ mode: \"manual\", title }),\n        headers: { \"content-type\": \"application/json\" },\n        method: \"PATCH\",\n      }),\n    );\n    return surveyAssistantThreadSchema.parse(body.thread);\n  },\n  async setAutomaticTitle(threadId, title) {\n    const body = await readSurveyAssistantJson(\n      await fetch(`${api}/${encodeURIComponent(threadId)}`, {\n        body: JSON.stringify({ mode: \"automatic\", ...(title ? { title } : {}) }),\n        headers: { \"content-type\": \"application/json\" },\n        method: \"PATCH\",\n      }),\n    );\n    return surveyAssistantThreadSchema.parse(body.thread);\n  },\n});\n","import { useCallback, useEffect, useState } from \"react\";\nimport {\n  surveyAssistantModelCatalogSchema,\n  type SurveyAssistantModelCatalog,\n  type SurveyAssistantModelOption,\n} from \"../protocol\";\nimport { readSurveyAssistantJson } from \"./client-error\";\n\nconst DEFAULT_MODEL_STORAGE_KEY = \"survey-assistant-selected-model\";\n\nexport interface SurveyAssistantModelCatalogClient {\n  get(): Promise<SurveyAssistantModelCatalog>;\n}\n\nexport const createSurveyAssistantModelCatalogClient = (\n  api = \"/api/survey-assistant/models\",\n): SurveyAssistantModelCatalogClient => ({\n  async get() {\n    const body = await readSurveyAssistantJson(\n      await fetch(api, { cache: \"no-store\" }),\n      \"The assistant model catalog could not be loaded.\",\n    );\n    return surveyAssistantModelCatalogSchema.parse(body);\n  },\n});\n\nexport interface UseSurveyAssistantModelCatalogOptions {\n  api?: string;\n  client?: SurveyAssistantModelCatalogClient;\n  onModelChange?(modelId: string): void;\n  storageKey?: string | false;\n}\n\nexport interface SurveyAssistantModelCatalogState {\n  error: Error | null;\n  loading: boolean;\n  modelId?: string;\n  models: SurveyAssistantModelOption[];\n  reload(): void;\n  selectModel(modelId: string): void;\n}\n\nexport const useSurveyAssistantModelCatalog = ({\n  api,\n  client: providedClient,\n  onModelChange,\n  storageKey = DEFAULT_MODEL_STORAGE_KEY,\n}: UseSurveyAssistantModelCatalogOptions = {}): SurveyAssistantModelCatalogState => {\n  const [models, setModels] = useState<SurveyAssistantModelOption[]>([]);\n  const [modelId, setModelId] = useState<string>();\n  const [error, setError] = useState<Error | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [reloadToken, setReloadToken] = useState(0);\n\n  useEffect(() => {\n    let cancelled = false;\n    const client = providedClient ?? createSurveyAssistantModelCatalogClient(api);\n    setLoading(true);\n    setError(null);\n    void client\n      .get()\n      .then((catalog) => {\n        if (cancelled) return;\n        const rememberedId =\n          storageKey && typeof window !== \"undefined\"\n            ? (window.localStorage.getItem(storageKey) ?? undefined)\n            : undefined;\n        const selectedId =\n          rememberedId && catalog.models.some((model) => model.id === rememberedId)\n            ? rememberedId\n            : catalog.defaultModelId;\n        setModels(catalog.models);\n        setModelId(selectedId);\n        onModelChange?.(selectedId);\n      })\n      .catch((reason: unknown) => {\n        if (!cancelled) setError(reason instanceof Error ? reason : new Error(String(reason)));\n      })\n      .finally(() => {\n        if (!cancelled) setLoading(false);\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [api, onModelChange, providedClient, reloadToken, storageKey]);\n\n  const selectModel = useCallback(\n    (nextModelId: string) => {\n      if (!models.some((model) => model.id === nextModelId)) return;\n      setModelId(nextModelId);\n      if (storageKey && typeof window !== \"undefined\") {\n        window.localStorage.setItem(storageKey, nextModelId);\n      }\n      onModelChange?.(nextModelId);\n    },\n    [models, onModelChange, storageKey],\n  );\n\n  const reload = useCallback(() => setReloadToken((current) => current + 1), []);\n\n  return { error, loading, modelId, models, reload, selectModel };\n};\n","\"use client\";\n\nimport {\n  surveyDocumentVersionSchema,\n  type SurveyAssistantSnapshot,\n  type SurveyDocumentVersion,\n} from \"../protocol\";\n\nconst STORAGE_PREFIX = \"case-survey-assistant:settled-document:\";\nconst memoryBaselines = new Map<string, SurveyDocumentVersion>();\n\nconst getStorageKey = (resourceId: string, threadId: string) =>\n  `${STORAGE_PREFIX}${encodeURIComponent(resourceId)}:${encodeURIComponent(threadId)}`;\n\nconst getSessionStorage = (): Storage | undefined => {\n  if (typeof document === \"undefined\") return undefined;\n\n  try {\n    return window.sessionStorage;\n  } catch {\n    return undefined;\n  }\n};\n\nexport const readSettledDocumentVersion = ({\n  resourceId,\n  threadId,\n}: {\n  resourceId: string;\n  threadId: string;\n}): SurveyDocumentVersion | undefined => {\n  const storageKey = getStorageKey(resourceId, threadId);\n  const storedInMemory = memoryBaselines.get(storageKey);\n  if (storedInMemory) return { ...storedInMemory };\n\n  const serialized = getSessionStorage()?.getItem(storageKey);\n  if (!serialized) return undefined;\n\n  try {\n    const parsed = surveyDocumentVersionSchema.safeParse(JSON.parse(serialized));\n    if (!parsed.success) return undefined;\n    memoryBaselines.set(storageKey, parsed.data);\n    return { ...parsed.data };\n  } catch {\n    return undefined;\n  }\n};\n\nexport const writeSettledDocumentVersion = ({\n  resourceId,\n  snapshot,\n  threadId,\n}: {\n  resourceId: string;\n  snapshot: SurveyAssistantSnapshot;\n  threadId: string;\n}): void => {\n  const storageKey = getStorageKey(resourceId, threadId);\n  const version = surveyDocumentVersionSchema.parse(snapshot.version);\n  memoryBaselines.set(storageKey, version);\n\n  try {\n    getSessionStorage()?.setItem(storageKey, JSON.stringify(version));\n  } catch {\n    // In-memory continuity still works when browser storage is disabled or full.\n  }\n};\n","\"use client\";\n\nimport { useChat } from \"@ai-sdk/react\";\nimport type {\n  ApplyReceipt,\n  SurveyApplyResult,\n  SurveyAssistantApplyPolicy,\n  SurveyAssistantTurnFinal,\n  SurveyChangeSet,\n} from \"../protocol\";\nimport type { ChatStatus, FileUIPart, UIMessage } from \"ai\";\nimport {\n  useCallback,\n  useEffect,\n  useEffectEvent,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n} from \"react\";\nimport {\n  collectSurveyChangeSets,\n  createApplyReceipts,\n  resolveLatestSurveyTurnAuthorization,\n  resolveSurveyTurnOutcome,\n} from \"./turn-authorization\";\nimport { isSurveyAssistantTurnActive, reduceSurveyAssistantSessionState } from \"./session-state\";\nimport type { SurveyAssistantSessionState } from \"./session-state\";\nimport type { SurveyTurnOutcome } from \"./turn-authorization\";\nimport { createSurveyAssistantTransport } from \"./transport\";\nimport type { SurveyAssistantController } from \"./controller\";\nimport { readSettledDocumentVersion, writeSettledDocumentVersion } from \"./document-baseline\";\nimport {\n  applySurveyAssistantLaunchUIContext,\n  type SurveyAssistantLaunchUIContext,\n} from \"./thread-launcher\";\n\nconst createLocalId = (prefix: string) => {\n  const id = globalThis.crypto?.randomUUID?.() ?? Math.random().toString(36).slice(2);\n  return `${prefix}-${id}`;\n};\n\ntype AssistantTextPart = Extract<UIMessage[\"parts\"][number], { type: \"text\" }>;\n\nconst getAssistantTextParts = (message: UIMessage) =>\n  message.parts.filter(\n    (part): part is AssistantTextPart => part.type === \"text\" && part.text.trim().length > 0,\n  );\n\nconst findLastAssistantTextMessageIndex = (\n  messages: UIMessage[],\n  endExclusive = messages.length,\n) => {\n  for (let index = Math.min(messages.length, endExclusive) - 1; index >= 0; index -= 1) {\n    const message = messages[index];\n    if (message?.role === \"assistant\" && getAssistantTextParts(message).length > 0) return index;\n  }\n  return -1;\n};\n\nconst findLastUserMessageIndex = (messages: UIMessage[]) => {\n  for (let index = messages.length - 1; index >= 0; index -= 1) {\n    if (messages[index]?.role === \"user\") return index;\n  }\n  return -1;\n};\n\nconst pruneFailedMessagesForDisplay = (messages: UIMessage[]): UIMessage[] => {\n  const lastUserIndex = findLastUserMessageIndex(messages);\n  const lastCompletedAssistantIndex = findLastAssistantTextMessageIndex(messages);\n\n  if (lastUserIndex > lastCompletedAssistantIndex) return messages.slice(0, lastUserIndex + 1);\n  return lastCompletedAssistantIndex >= 0 ? messages.slice(0, lastCompletedAssistantIndex + 1) : [];\n};\n\nconst hasCompletedAssistantResponseAfterLastUser = (messages: UIMessage[]) => {\n  const lastUserIndex = findLastUserMessageIndex(messages);\n  return lastUserIndex >= 0 && findLastAssistantTextMessageIndex(messages) > lastUserIndex;\n};\n\nconst collectChangeSetsAfterLastUser = (messages: UIMessage[]) => {\n  const lastUserIndex = findLastUserMessageIndex(messages);\n  return lastUserIndex < 0 ? [] : collectSurveyChangeSets(messages.slice(lastUserIndex + 1));\n};\n\nexport interface SurveyAssistantSessionOptions {\n  api?: string;\n  /** Explicit host decision: apply immediately, present for review, or deny mutations. */\n  applyPolicy: SurveyAssistantApplyPolicy;\n  controller?: SurveyAssistantController | null;\n  initialMessages?: UIMessage[];\n  modelId?: string;\n  onApplyReceipts?: (receipts: ApplyReceipt[]) => void;\n  /**\n   * Production persistence/audit barrier. The turn remains active until this\n   * resolves; rejection leaves the settled baseline unchanged.\n   */\n  onSettleApply?: (input: {\n    changeSets: SurveyChangeSet[];\n    receipts: ApplyReceipt[];\n    turnFinal: SurveyAssistantTurnFinal;\n  }) => void | Promise<void>;\n  /**\n   * Required for `review`. Resolve true to apply the authorized change sets,\n   * or false to leave the editor unchanged.\n   */\n  onReviewChangeSets?: (\n    changeSets: SurveyChangeSet[],\n    turnFinal: SurveyAssistantTurnFinal,\n  ) => boolean | Promise<boolean>;\n  /** Reports when a turn owns the editor state, including submission, streaming, and apply. */\n  onTurnActiveChange?: (active: boolean) => void;\n  resourceId?: string;\n  /** Host survey id sent as untrusted request context for server-side authorization. */\n  surveyId?: string;\n  threadId?: string;\n}\n\nexport const resolveSurveyAssistantReviewDecision = async ({\n  changeSets,\n  onReviewChangeSets,\n  turnFinal,\n}: {\n  changeSets: SurveyChangeSet[];\n  onReviewChangeSets?: SurveyAssistantSessionOptions[\"onReviewChangeSets\"];\n  turnFinal: SurveyAssistantTurnFinal;\n}) => {\n  if (!onReviewChangeSets) {\n    throw new Error(\"No survey assistant review adapter is available.\");\n  }\n  return onReviewChangeSets(changeSets, turnFinal);\n};\n\nexport interface SurveyAssistantSubmitMessage {\n  text: string;\n  files: FileUIPart[];\n  /** Turn-local UI context layered over the controller snapshot for this submission. */\n  uiContext?: SurveyAssistantLaunchUIContext;\n}\n\nexport interface SurveyAssistantSession {\n  applyResultsByChangeId: Record<string, SurveyApplyResult>;\n  authorizationError: string | null;\n  dismissError(): void;\n  error: Error | undefined;\n  isStreaming: boolean;\n  latestTurnOutcome: SurveyTurnOutcome | null;\n  messages: UIMessage[];\n  state: SurveyAssistantSessionState;\n  status: ChatStatus;\n  stop(): void;\n  submit(message: SurveyAssistantSubmitMessage): boolean;\n  retry(): void;\n}\n\nexport const useSurveyAssistantSession = ({\n  api,\n  applyPolicy,\n  controller,\n  initialMessages = [],\n  modelId,\n  onApplyReceipts,\n  onSettleApply,\n  onReviewChangeSets,\n  onTurnActiveChange,\n  resourceId: controlledResourceId,\n  surveyId,\n  threadId: controlledThreadId,\n}: SurveyAssistantSessionOptions): SurveyAssistantSession => {\n  const [localResourceId] = useState(() => createLocalId(\"survey-assistant-local-user\"));\n  const [localThreadId] = useState(() => createLocalId(\"survey-assistant-local-thread\"));\n  const resourceId = controlledResourceId ?? localResourceId;\n  const threadId = controlledThreadId ?? localThreadId;\n  const [state, dispatch] = useReducer(reduceSurveyAssistantSessionState, \"idle\");\n  const [applyResultsByChangeId, setApplyResultsByChangeId] = useState<\n    Record<string, SurveyApplyResult>\n  >({});\n  const [authorizationError, setAuthorizationError] = useState<string | null>(null);\n  const handledTurnIdsRef = useRef<Set<string>>(new Set());\n  const localTurnAwaitingApplyRef = useRef(false);\n  const localTurnStreamStartedRef = useRef(false);\n  const captureSettledVersionRef = useRef(false);\n  const lastSubmittedUIContextRef = useRef<SurveyAssistantLaunchUIContext | undefined>(undefined);\n\n  const transport = useMemo(\n    () => createSurveyAssistantTransport({ api, resourceId, surveyId, threadId }),\n    [api, resourceId, surveyId, threadId],\n  );\n  const {\n    messages,\n    setMessages,\n    sendMessage,\n    status,\n    stop: stopChat,\n    error,\n    clearError,\n    regenerate,\n  } = useChat({ id: threadId, messages: initialMessages, transport });\n  const isStreaming = status === \"submitted\" || status === \"streaming\";\n  const isTurnActive = isSurveyAssistantTurnActive({ isStreaming, state });\n  const notifyTurnActiveChange = useEffectEvent((active: boolean) => {\n    onTurnActiveChange?.(active);\n  });\n  const turnAuthorization = useMemo(\n    () => resolveLatestSurveyTurnAuthorization(messages),\n    [messages],\n  );\n  const latestTurnOutcome = useMemo(\n    () => resolveSurveyTurnOutcome({ applyResultsByChangeId, authorization: turnAuthorization }),\n    [applyResultsByChangeId, turnAuthorization],\n  );\n  const hasUsefulLatestAssistantResponse = useMemo(\n    () =>\n      hasCompletedAssistantResponseAfterLastUser(messages) ||\n      collectChangeSetsAfterLastUser(messages).length > 0,\n    [messages],\n  );\n\n  const reportAuthorizationError = useCallback((message: string) => {\n    queueMicrotask(() => {\n      setAuthorizationError(message);\n      dispatch({ type: \"failed\" });\n    });\n  }, []);\n\n  useEffect(() => {\n    if (status === \"submitted\") dispatch({ type: \"submit\" });\n    if (status === \"streaming\") dispatch({ type: \"stream-started\" });\n  }, [status]);\n\n  useEffect(() => {\n    notifyTurnActiveChange(isTurnActive);\n\n    return () => {\n      if (isTurnActive) notifyTurnActiveChange(false);\n    };\n  }, [isTurnActive]);\n\n  useEffect(() => {\n    if (\n      !captureSettledVersionRef.current ||\n      isStreaming ||\n      (state !== \"completed\" && state !== \"failed\" && state !== \"aborted\" && state !== \"applied\")\n    ) {\n      return;\n    }\n\n    captureSettledVersionRef.current = false;\n    const snapshot = controller?.getSnapshot();\n    if (snapshot) {\n      writeSettledDocumentVersion({ resourceId, snapshot, threadId });\n    }\n  }, [controller, isStreaming, resourceId, state, threadId]);\n\n  useEffect(() => {\n    if (isStreaming) {\n      localTurnStreamStartedRef.current = true;\n      return;\n    }\n    if (!localTurnAwaitingApplyRef.current) return;\n\n    if (turnAuthorization.status === \"pending\") {\n      if (!localTurnStreamStartedRef.current) return;\n      const timeoutId = window.setTimeout(() => {\n        localTurnAwaitingApplyRef.current = false;\n        localTurnStreamStartedRef.current = false;\n        reportAuthorizationError(\"The assistant response ended without a valid turn final.\");\n      }, 100);\n      return () => window.clearTimeout(timeoutId);\n    }\n\n    localTurnAwaitingApplyRef.current = false;\n    localTurnStreamStartedRef.current = false;\n    if (turnAuthorization.status === \"invalid\") {\n      reportAuthorizationError(turnAuthorization.reason);\n      return;\n    }\n\n    const { turnFinal } = turnAuthorization;\n    if (handledTurnIdsRef.current.has(turnFinal.turnId)) return;\n    handledTurnIdsRef.current.add(turnFinal.turnId);\n\n    if (turnAuthorization.status !== \"completed\" || turnAuthorization.changeSets.length === 0) {\n      dispatch({ type: \"completed\" });\n      return;\n    }\n    if (applyPolicy === \"deny\") {\n      dispatch({ type: \"completed\" });\n      return;\n    }\n    dispatch({ type: \"apply-started\" });\n    void (async () => {\n      if (applyPolicy === \"review\") {\n        let approved: boolean;\n        try {\n          approved = await resolveSurveyAssistantReviewDecision({\n            changeSets: turnAuthorization.changeSets,\n            onReviewChangeSets,\n            turnFinal,\n          });\n        } catch (error) {\n          reportAuthorizationError(\n            error instanceof Error &&\n              error.message === \"No survey assistant review adapter is available.\"\n              ? error.message\n              : \"The survey assistant review could not be completed.\",\n          );\n          return;\n        }\n        if (!approved) {\n          dispatch({ type: \"completed\" });\n          return;\n        }\n      }\n\n      if (!controller?.applyAssistantChange && !controller?.applyAssistantChanges) {\n        reportAuthorizationError(\"No survey editor apply adapter is available.\");\n        return;\n      }\n      const beforeSnapshot = controller.getSnapshot();\n      if (!beforeSnapshot) {\n        reportAuthorizationError(\n          \"The editor state was unavailable when applying the assistant change.\",\n        );\n        return;\n      }\n\n      const result = controller.applyAssistantChanges?.(turnAuthorization.changeSets) ?? {\n        results: turnAuthorization.changeSets\n          .map((change) => controller.applyAssistantChange?.(change))\n          .filter((applyResult): applyResult is SurveyApplyResult => Boolean(applyResult)),\n      };\n      queueMicrotask(() =>\n        setApplyResultsByChangeId((current) => ({\n          ...current,\n          ...Object.fromEntries(\n            result.results.map((applyResult) => [applyResult.changeId, applyResult]),\n          ),\n        })),\n      );\n      const receipts = createApplyReceipts({\n        beforeSnapshot,\n        afterSnapshot: controller.getSnapshot(),\n        changeSets: turnAuthorization.changeSets,\n        results: result.results,\n        turnFinal,\n      });\n      onApplyReceipts?.(receipts);\n      if (!result.results.every((applyResult) => applyResult.status === \"applied\")) {\n        dispatch({ type: \"completed\" });\n        return;\n      }\n      try {\n        await onSettleApply?.({\n          changeSets: turnAuthorization.changeSets,\n          receipts,\n          turnFinal,\n        });\n        dispatch({ type: \"applied\" });\n      } catch {\n        reportAuthorizationError(\n          \"The assistant changes were applied locally but could not be settled by the host.\",\n        );\n      }\n    })();\n  }, [\n    applyPolicy,\n    controller,\n    isStreaming,\n    onApplyReceipts,\n    onReviewChangeSets,\n    onSettleApply,\n    reportAuthorizationError,\n    turnAuthorization,\n  ]);\n\n  useEffect(() => {\n    if (!error) return;\n    localTurnAwaitingApplyRef.current = false;\n    localTurnStreamStartedRef.current = false;\n    dispatch({ type: \"failed\" });\n    if (!hasUsefulLatestAssistantResponse) setMessages(pruneFailedMessagesForDisplay);\n  }, [error, hasUsefulLatestAssistantResponse, setMessages]);\n\n  const submit = useCallback(\n    ({ files, text: rawText, uiContext }: SurveyAssistantSubmitMessage) => {\n      const text = rawText.trim();\n      if (!text && files.length === 0) return false;\n      if (isStreaming || localTurnAwaitingApplyRef.current) return false;\n\n      localTurnAwaitingApplyRef.current = true;\n      localTurnStreamStartedRef.current = false;\n      setAuthorizationError(null);\n      if (authorizationError || error) setMessages(pruneFailedMessagesForDisplay);\n      clearError();\n      dispatch({ type: \"submit\" });\n      captureSettledVersionRef.current = true;\n      lastSubmittedUIContextRef.current = uiContext;\n\n      const controllerSnapshot = controller?.getSnapshot() ?? null;\n      const snapshot = applySurveyAssistantLaunchUIContext(controllerSnapshot, uiContext);\n      void sendMessage(files.length > 0 ? (text ? { text, files } : { files }) : { text }, {\n        body: {\n          snapshot,\n          previousSettledVersion: readSettledDocumentVersion({ resourceId, threadId }),\n          ...(modelId ? { modelId } : {}),\n        },\n      });\n      return true;\n    },\n    [\n      authorizationError,\n      clearError,\n      controller,\n      error,\n      isStreaming,\n      modelId,\n      resourceId,\n      sendMessage,\n      setMessages,\n      threadId,\n    ],\n  );\n\n  const stop = useCallback(() => {\n    localTurnAwaitingApplyRef.current = false;\n    localTurnStreamStartedRef.current = false;\n    dispatch({ type: \"aborted\" });\n    void stopChat();\n  }, [stopChat]);\n\n  const retry = useCallback(() => {\n    localTurnAwaitingApplyRef.current = true;\n    localTurnStreamStartedRef.current = false;\n    setAuthorizationError(null);\n    clearError();\n    dispatch({ type: \"submit\" });\n    captureSettledVersionRef.current = true;\n    const controllerSnapshot = controller?.getSnapshot() ?? null;\n    const uiContext = lastSubmittedUIContextRef.current;\n    const snapshot = applySurveyAssistantLaunchUIContext(controllerSnapshot, uiContext);\n    void regenerate({\n      body: {\n        snapshot,\n        previousSettledVersion: readSettledDocumentVersion({ resourceId, threadId }),\n        ...(modelId ? { modelId } : {}),\n      },\n    });\n  }, [clearError, controller, modelId, regenerate, resourceId, threadId]);\n\n  const dismissError = useCallback(() => {\n    localTurnAwaitingApplyRef.current = false;\n    localTurnStreamStartedRef.current = false;\n    setMessages(pruneFailedMessagesForDisplay);\n    setAuthorizationError(null);\n    clearError();\n    dispatch({ type: \"reset\", hasTranscript: messages.length > 0 });\n  }, [clearError, messages.length, setMessages]);\n\n  return {\n    applyResultsByChangeId,\n    authorizationError,\n    dismissError,\n    error,\n    isStreaming,\n    latestTurnOutcome,\n    messages,\n    state,\n    status,\n    stop,\n    submit,\n    retry,\n  };\n};\n"],"mappings":"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"}

package/dist/react-integration.d.mts

@@ -1,2 +1,2 @@
-import { a as SurveyAssistantController, c as SurveyAssistantTaskExecutionOptions, d as SurveyAssistantTaskExecutorRequestOptions, f as createSurveyAssistantTaskClient, i as createSurveyAssistantControllerProxy, l as SurveyAssistantTaskExecutor, n as SurveyAssistantControllerBridge, o as SurveyAssistantTaskClient, p as createSurveyAssistantTaskExecutor, r as createSurveyAssistantControllerBridge, s as SurveyAssistantTaskClientOptions, t as CreateSurveyAssistantControllerProxyOptions, u as SurveyAssistantTaskExecutorCacheContext } from "./controller-proxy-BRDusFiO.mjs";
-export { type CreateSurveyAssistantControllerProxyOptions, type SurveyAssistantController, type SurveyAssistantControllerBridge, type SurveyAssistantTaskClient, type SurveyAssistantTaskClientOptions, type SurveyAssistantTaskExecutionOptions, type SurveyAssistantTaskExecutor, type SurveyAssistantTaskExecutorCacheContext, type SurveyAssistantTaskExecutorRequestOptions, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor };
+import { _ as createSurveyAssistantThreadLauncher, a as SurveyAssistantController, c as SurveyAssistantTaskExecutionOptions, d as SurveyAssistantTaskExecutorRequestOptions, f as createSurveyAssistantTaskClient, g as SurveyAssistantThreadLauncher, h as SurveyAssistantThreadLaunch, i as createSurveyAssistantControllerProxy, l as SurveyAssistantTaskExecutor, m as SurveyAssistantLaunchUIContext, n as SurveyAssistantControllerBridge, o as SurveyAssistantTaskClient, p as createSurveyAssistantTaskExecutor, r as createSurveyAssistantControllerBridge, s as SurveyAssistantTaskClientOptions, t as CreateSurveyAssistantControllerProxyOptions, u as SurveyAssistantTaskExecutorCacheContext } from "./controller-proxy-2VH0b_5E.mjs";
+export { type CreateSurveyAssistantControllerProxyOptions, type SurveyAssistantController, type SurveyAssistantControllerBridge, type SurveyAssistantLaunchUIContext, type SurveyAssistantTaskClient, type SurveyAssistantTaskClientOptions, type SurveyAssistantTaskExecutionOptions, type SurveyAssistantTaskExecutor, type SurveyAssistantTaskExecutorCacheContext, type SurveyAssistantTaskExecutorRequestOptions, type SurveyAssistantThreadLaunch, type SurveyAssistantThreadLauncher, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadLauncher };

package/dist/react-integration.mjs

@@ -1,3 +1,3 @@
 "use client";
-import { i as createSurveyAssistantTaskExecutor, n as createSurveyAssistantControllerProxy, r as createSurveyAssistantTaskClient, t as createSurveyAssistantControllerBridge } from "./controller-proxy-Duxo2IFE.mjs";
-export { createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor };
+import { i as createSurveyAssistantTaskExecutor, n as createSurveyAssistantControllerProxy, r as createSurveyAssistantTaskClient, s as createSurveyAssistantThreadLauncher, t as createSurveyAssistantControllerBridge } from "./controller-proxy-ClsY4lFI.mjs";
+export { createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadLauncher };

package/dist/react.d.mts

@@ -1,3 +1,3 @@
-import { C as SurveyAssistantSessionEvent, E as reduceSurveyAssistantSessionState, S as unwrapSurveyAssistantToolOutput, T as isSurveyAssistantTurnActive, _ as createApplyReceipts, a as SurveyAssistantModelCatalogClient, b as resolveLatestSurveyTurnAuthorization, c as createSurveyAssistantModelCatalogClient, d as SurveyAssistantThreadClient, f as createSurveyAssistantThreadClient, g as collectSurveyChangeSets, h as SurveyTurnOutcome, i as useSurveyAssistantSession, l as useSurveyAssistantModelCatalog, m as SurveyTurnAuthorization, n as SurveyAssistantSessionOptions, o as SurveyAssistantModelCatalogState, p as createSurveyAssistantTransport, r as SurveyAssistantSubmitMessage, s as UseSurveyAssistantModelCatalogOptions, t as SurveyAssistantSession, u as SurveyAssistantClientError, v as getSurveyDocumentVersionFromSnapshot, w as SurveyAssistantSessionState, x as resolveSurveyTurnOutcome, y as parseSurveyChangeSet } from "./index-BWNHkpkh.mjs";
-import { a as SurveyAssistantController, c as SurveyAssistantTaskExecutionOptions, d as SurveyAssistantTaskExecutorRequestOptions, f as createSurveyAssistantTaskClient, i as createSurveyAssistantControllerProxy, l as SurveyAssistantTaskExecutor, n as SurveyAssistantControllerBridge, o as SurveyAssistantTaskClient, p as createSurveyAssistantTaskExecutor, r as createSurveyAssistantControllerBridge, s as SurveyAssistantTaskClientOptions, t as CreateSurveyAssistantControllerProxyOptions, u as SurveyAssistantTaskExecutorCacheContext } from "./controller-proxy-BRDusFiO.mjs";
-export { CreateSurveyAssistantControllerProxyOptions, SurveyAssistantClientError, SurveyAssistantController, SurveyAssistantControllerBridge, SurveyAssistantModelCatalogClient, SurveyAssistantModelCatalogState, SurveyAssistantSession, SurveyAssistantSessionEvent, SurveyAssistantSessionOptions, SurveyAssistantSessionState, SurveyAssistantSubmitMessage, SurveyAssistantTaskClient, SurveyAssistantTaskClientOptions, SurveyAssistantTaskExecutionOptions, SurveyAssistantTaskExecutor, SurveyAssistantTaskExecutorCacheContext, SurveyAssistantTaskExecutorRequestOptions, SurveyAssistantThreadClient, SurveyTurnAuthorization, SurveyTurnOutcome, UseSurveyAssistantModelCatalogOptions, collectSurveyChangeSets, createApplyReceipts, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantModelCatalogClient, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadClient, createSurveyAssistantTransport, getSurveyDocumentVersionFromSnapshot, isSurveyAssistantTurnActive, parseSurveyChangeSet, reduceSurveyAssistantSessionState, resolveLatestSurveyTurnAuthorization, resolveSurveyTurnOutcome, unwrapSurveyAssistantToolOutput, useSurveyAssistantModelCatalog, useSurveyAssistantSession };
+import { C as SurveyAssistantSessionEvent, E as reduceSurveyAssistantSessionState, S as unwrapSurveyAssistantToolOutput, T as isSurveyAssistantTurnActive, _ as createApplyReceipts, a as SurveyAssistantModelCatalogClient, b as resolveLatestSurveyTurnAuthorization, c as createSurveyAssistantModelCatalogClient, d as SurveyAssistantThreadClient, f as createSurveyAssistantThreadClient, g as collectSurveyChangeSets, h as SurveyTurnOutcome, i as useSurveyAssistantSession, l as useSurveyAssistantModelCatalog, m as SurveyTurnAuthorization, n as SurveyAssistantSessionOptions, o as SurveyAssistantModelCatalogState, p as createSurveyAssistantTransport, r as SurveyAssistantSubmitMessage, s as UseSurveyAssistantModelCatalogOptions, t as SurveyAssistantSession, u as SurveyAssistantClientError, v as getSurveyDocumentVersionFromSnapshot, w as SurveyAssistantSessionState, x as resolveSurveyTurnOutcome, y as parseSurveyChangeSet } from "./index-C_x686M7.mjs";
+import { _ as createSurveyAssistantThreadLauncher, a as SurveyAssistantController, c as SurveyAssistantTaskExecutionOptions, d as SurveyAssistantTaskExecutorRequestOptions, f as createSurveyAssistantTaskClient, g as SurveyAssistantThreadLauncher, h as SurveyAssistantThreadLaunch, i as createSurveyAssistantControllerProxy, l as SurveyAssistantTaskExecutor, m as SurveyAssistantLaunchUIContext, n as SurveyAssistantControllerBridge, o as SurveyAssistantTaskClient, p as createSurveyAssistantTaskExecutor, r as createSurveyAssistantControllerBridge, s as SurveyAssistantTaskClientOptions, t as CreateSurveyAssistantControllerProxyOptions, u as SurveyAssistantTaskExecutorCacheContext } from "./controller-proxy-2VH0b_5E.mjs";
+export { CreateSurveyAssistantControllerProxyOptions, SurveyAssistantClientError, SurveyAssistantController, SurveyAssistantControllerBridge, SurveyAssistantLaunchUIContext, SurveyAssistantModelCatalogClient, SurveyAssistantModelCatalogState, SurveyAssistantSession, SurveyAssistantSessionEvent, SurveyAssistantSessionOptions, SurveyAssistantSessionState, SurveyAssistantSubmitMessage, SurveyAssistantTaskClient, SurveyAssistantTaskClientOptions, SurveyAssistantTaskExecutionOptions, SurveyAssistantTaskExecutor, SurveyAssistantTaskExecutorCacheContext, SurveyAssistantTaskExecutorRequestOptions, SurveyAssistantThreadClient, SurveyAssistantThreadLaunch, SurveyAssistantThreadLauncher, SurveyTurnAuthorization, SurveyTurnOutcome, UseSurveyAssistantModelCatalogOptions, collectSurveyChangeSets, createApplyReceipts, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantModelCatalogClient, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadClient, createSurveyAssistantThreadLauncher, createSurveyAssistantTransport, getSurveyDocumentVersionFromSnapshot, isSurveyAssistantTurnActive, parseSurveyChangeSet, reduceSurveyAssistantSessionState, resolveLatestSurveyTurnAuthorization, resolveSurveyTurnOutcome, unwrapSurveyAssistantToolOutput, useSurveyAssistantModelCatalog, useSurveyAssistantSession };

package/dist/react.mjs

@@ -1,4 +1,4 @@
 "use client";
-import { a as createSurveyAssistantTransport, c as getSurveyDocumentVersionFromSnapshot, d as resolveSurveyTurnOutcome, f as unwrapSurveyAssistantToolOutput, i as createSurveyAssistantThreadClient, l as parseSurveyChangeSet, m as reduceSurveyAssistantSessionState, n as createSurveyAssistantModelCatalogClient, o as collectSurveyChangeSets, p as isSurveyAssistantTurnActive, r as useSurveyAssistantModelCatalog, s as createApplyReceipts, t as useSurveyAssistantSession, u as resolveLatestSurveyTurnAuthorization } from "./react-VuYe-cPh.mjs";
-import { a as SurveyAssistantClientError, i as createSurveyAssistantTaskExecutor, n as createSurveyAssistantControllerProxy, r as createSurveyAssistantTaskClient, t as createSurveyAssistantControllerBridge } from "./controller-proxy-Duxo2IFE.mjs";
-export { SurveyAssistantClientError, collectSurveyChangeSets, createApplyReceipts, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantModelCatalogClient, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadClient, createSurveyAssistantTransport, getSurveyDocumentVersionFromSnapshot, isSurveyAssistantTurnActive, parseSurveyChangeSet, reduceSurveyAssistantSessionState, resolveLatestSurveyTurnAuthorization, resolveSurveyTurnOutcome, unwrapSurveyAssistantToolOutput, useSurveyAssistantModelCatalog, useSurveyAssistantSession };
+import { a as createSurveyAssistantTransport, c as getSurveyDocumentVersionFromSnapshot, d as resolveSurveyTurnOutcome, f as unwrapSurveyAssistantToolOutput, i as createSurveyAssistantThreadClient, l as parseSurveyChangeSet, m as reduceSurveyAssistantSessionState, n as createSurveyAssistantModelCatalogClient, o as collectSurveyChangeSets, p as isSurveyAssistantTurnActive, r as useSurveyAssistantModelCatalog, s as createApplyReceipts, t as useSurveyAssistantSession, u as resolveLatestSurveyTurnAuthorization } from "./react-B_5smfiK.mjs";
+import { c as SurveyAssistantClientError, i as createSurveyAssistantTaskExecutor, n as createSurveyAssistantControllerProxy, r as createSurveyAssistantTaskClient, s as createSurveyAssistantThreadLauncher, t as createSurveyAssistantControllerBridge } from "./controller-proxy-ClsY4lFI.mjs";
+export { SurveyAssistantClientError, collectSurveyChangeSets, createApplyReceipts, createSurveyAssistantControllerBridge, createSurveyAssistantControllerProxy, createSurveyAssistantModelCatalogClient, createSurveyAssistantTaskClient, createSurveyAssistantTaskExecutor, createSurveyAssistantThreadClient, createSurveyAssistantThreadLauncher, createSurveyAssistantTransport, getSurveyDocumentVersionFromSnapshot, isSurveyAssistantTurnActive, parseSurveyChangeSet, reduceSurveyAssistantSessionState, resolveLatestSurveyTurnAuthorization, resolveSurveyTurnOutcome, unwrapSurveyAssistantToolOutput, useSurveyAssistantModelCatalog, useSurveyAssistantSession };

package/dist/references/assistant-operations.md

@@ -25,6 +25,11 @@ an item that has not been applied yet.
 
 ## `survey_change` Typed Operations
 
+For the canonical fields of one operation, call `survey_authoring_reference` again with
+`topic: "assistant-operations"` and that `operationKind`. The returned JSON Schema is generated
+from the same validator used by `survey_change`, so this reference does not duplicate a static
+operation catalog.
+
 `create-item`
 
 - Creates a new item under `target.parentItemId`.
@@ -188,6 +193,7 @@ Minimal valid examples:
 
 - Add or remove a choice option's inline form using item and option ids, without raw array-index patches.
 - `set-embedded-form` accepts the full form config plus its visible translations in the same operation.
+- Form layout values are responsive column counts from 1 to 4, not spans; one column makes a lone field full width.
 
 `move-item`, `reorder-items`
 

package/dist/references/core-rules.md

@@ -8,4 +8,10 @@ Core rules:
 - For long surveys, do not rely on the compact outline alone. Use survey_inspect action=current-context with scope=outline, cursor/limit, and outlineMode=full for survey-wide order; outlineMode=children with itemRef for a specific parent; search-items for text lookup. Never guess append indexes or references from an outline that says it is truncated.
 - Use typed `survey_change` operations for common edits and `survey_expression` for expressions on existing state. Use raw JSON Patch only for assistant-editable fields not covered by either specialized path.
 - Always validate/propose edits through `survey_change` or `survey_expression` prepare mode. A validated candidate is not proof of browser application; never present rejected, superseded, or incomplete work as completed.
+- Treat every identifier as exact data across every item type: item ids/keys, response-slot ids,
+  option ids/keys, field and group ids/keys, component keys, validation keys, prefill ids, template
+  keys, content keys, and custom-capability identifiers. Never humanize them by changing case,
+  inserting/removing separators, splitting camelCase, or substituting a label/title/name. Visible
+  prose belongs in translations or editor labels. When explaining an existing survey, quote the
+  exact inspected identifier.
 - Load only the reference you need: survey-data-model.md, source-material-surveys.md, localization.md, rich-text-content.md, item-types.md, embedded-forms.md, expressions.md, or assistant-operations.md.

package/dist/references/embedded-forms.md

@@ -8,12 +8,14 @@ Use this reference when a choice option needs an inline input such as “Other,
 - There is no `allowOther` flag. The option config field is `embeddedForm`.
 - For a newly created choice item, put the option and its `embeddedForm` directly in the same
   `create-item` operation, with every required translation in `create-item.translations`.
-- For an existing choice item, inspect the exact item and option with `survey_inspect`, including
-  its survey-root raw path. Then make one `survey_change` call containing exactly one
-  `survey-json-patch` operation. Put the config patch and every translation patch together in that
-  operation's single plural `patches` array.
-- Never combine a `survey-json-patch` operation with typed translation operations in the same
-  proposal. A raw patch must be the only operation.
+- For an existing option, inspect its exact item and option ids, then use `set-embedded-form`.
+  Put the complete form structure and all visible content in that operation's `translations`.
+  The `translations` property belongs inside the `set-embedded-form` operation object, never beside
+  the `survey_change` `operations` array.
+- To add the option and form together, use one `survey_change` proposal containing
+  `add-choice-option` with an explicit stable id, immediately followed by `set-embedded-form`
+  targeting that id.
+- Use `survey-json-patch` only for editable behavior that these typed operations cannot represent.
 
 ## Exact Config Shape
 
@@ -23,6 +25,9 @@ The config key is singular `embeddedForm`, but translation content-key prefixes
 `embeddedForm` is a flat object containing `id` and `fieldGroups`. Fields belong inside each field
 group; there is no `itemType`, `config`, or top-level `fields` wrapper.
 
+`fieldGroups[].layout` values are responsive column counts, not field spans. Use `1` at every
+breakpoint for one full-width field. Supported counts are `1` through `4`.
+
 ```json
 {
   "id": "other",
@@ -50,7 +55,9 @@ group; there is no `itemType`, `config`, or top-level `fields` wrapper.
 ```
 
 Use an explicit, stable option id. The config option id, translation prefix, and embedded response
-reference must agree exactly.
+reference must agree exactly. When editing an existing option, copy its current `id` exactly,
+including case. The `embeddedForms.<optionId>` translation segment always comes from the containing
+choice option's `id`; it does not come from the option `key` or the nested `embeddedForm.id`.
 
 ## Required Content
 
@@ -67,14 +74,14 @@ Every embedded field requires a visible label translation in the same atomic pro
 Do not duplicate completion wording in both the option and field labels. For “Other, please
 specify”, use option label “Other” and field label “Please specify”.
 
-## Existing-Item Raw Patch Checklist
+## Existing-Item Typed Operation Checklist
 
-1. Inspect the existing choice item and identify the exact option index/id and item JSON Pointer.
-2. Add or replace `<itemPath>/config/options/<optionIndex>/embeddedForm`.
-3. Add each required dotted content-key leaf under
-   `/translations/<locale>/itemTranslations/<itemId>/...`.
-4. Preserve the existing locale and item-translation containers; never replace either whole branch.
-5. Submit all entries as one `survey-json-patch` operation in one `survey_change` call.
+1. Inspect the existing choice item and copy the exact item and option ids.
+2. Call `set-embedded-form` with the complete flat form structure.
+3. Use canonical field types such as `input`, with a matching controller; there is no `text` type.
+4. Put relative content keys such as `fields.other_text.label` in the same operation's
+   `translations`; the engine adds `embeddedForms.<optionId>.` automatically.
+5. Use one column at every breakpoint when a lone field should fill the form width.
 
 Embedded response slots use `embedded.<optionId>.<fieldKey>`, for example
 `embedded.other.other_text`.

package/dist/references/expressions.md

@@ -37,6 +37,9 @@ Methods:
 - `isDefined`: returns boolean true when a response exists.
 
 Never invent response refs. Use the current context response-slots scope or item details.
+This rule is item-type independent: preserve every item id, slot id, component/validation key,
+prefill id, template key, and reference constant exactly as inspected. Never humanize an identifier
+for display or explanation; if a coding key exists, show that exact key, otherwise show the exact id.
 The live snapshot is immutable for the whole assistant response. `survey_change` validates and
 registers a candidate; it does not change what later tools can inspect. The browser applies authorized change sets
 only after the response completes successfully. A validated candidate is intended for apply if the turn succeeds;