@case-framework/survey-assistant 0.3.0 → 0.5.0

package/README.md

@@ -46,6 +46,7 @@ import {
 
 import {
   createSurveyAssistantRuntime,
+  parseSurveyAssistantConfigurationDocument,
   parseSurveyAssistantEnvironment,
 } from "@case-framework/survey-assistant/server/runtime";
 
@@ -84,9 +85,10 @@ Markdown authoring references. `/server/tools` owns the standard
 request-context tools, and `/server/agent` owns their Agent,
 instructions, thread-scoped Observational Memory defaults, and optional
 history-compatibility policy for custom memory setups. `/server/runtime` is the
-high-level composition layer: it parses an injected environment, resolves the
-approved provider/model catalog (including optional Azure deployment
-discovery), applies independent same-provider task and memory model policy,
+high-level composition layer: it parses a versioned provider/model policy
+document or the legacy injected environment, resolves the approved model catalog
+(including optional Azure deployment discovery), applies same-provider chat,
+task, and memory roles,
 exposes standard Mastra agents and gateways, and creates the Web handlers. The
 host still constructs the standard Mastra instance and owns
 credentials, authorization, storage connection lifecycle, logging, and route
@@ -172,6 +174,12 @@ For the supported real-app setup, configuration reference, route/auth contract,
 attachment policy, apply settlement, observability, cleanup, and acceptance
 checklist, see [Real-host integration](./docs/integration.md).
 
+The repository's Survey Editor host keeps its active configuration local. Start
+from
+[`apps/survey-editor/config/survey-assistant.example.yaml`](../../apps/survey-editor/config/survey-assistant.example.yaml)
+and keep provider credentials in the environment variables named by
+`apiKeyEnv`.
+
 `createSurveyAssistantSurveyLifecycle(...).forSurvey(surveyId, resourceId)`
 provides one shared thread identity, chat authorizer, panel-prop object, and
 per-user cleanup method so those paths cannot drift onto different survey
@@ -258,7 +266,7 @@ variables, create hidden singletons, or own connection shutdown.
 Use the highest level that fits the host; the lower layers remain available for
 custom authentication, provider policy, UI, or storage.
 
-- **Standard server:** `parseSurveyAssistantEnvironment` plus
+- **Standard server:** `parseSurveyAssistantConfigurationDocument` plus
   `createSurveyAssistantRuntime`, then register its `agents` and `gateways` in a
   normal `Mastra` instance and call `runtime.createHandlers(...)`.
 - **Custom server:** compose `createSurveyAssistantAgent`, individual chat,
@@ -270,3 +278,11 @@ custom authentication, provider policy, UI, or storage.
 
 The high-level APIs are thin composition helpers over the same exported
 primitives. They do not introduce a second runtime or hide Mastra.
+
+Importing hosts can optionally require the additional
+`SURVEY_ASSISTANT_ALLOW_EXPERIMENTAL_IDENTITY=true` production rollout gate by
+passing `requireExperimentalIdentityOptIn: true` to a configuration parser.
+The option does not choose or authorize an identity, and most authenticated
+hosts should omit it unless they want that extra deployment switch. See
+[Real-host integration](./docs/integration.md#optional-experimental-identity-rollout-gate)
+for the exact enablement rules.

package/dist/capabilities-default.d.mts

@@ -1,4 +1,4 @@
-import { Bt as SurveyAssistantCapabilitySet, It as AssistantItemCapabilityAdapter } from "./index-Bo4dHAo8.mjs";
+import { Ut as SurveyAssistantCapabilitySet, zt as AssistantItemCapabilityAdapter } from "./index-Da_Hb9-1.mjs";
 
 //#region src/capabilities/default.d.ts
 declare const rootItemAssistantCapability: AssistantItemCapabilityAdapter;

package/dist/capabilities-default.mjs

@@ -1,4 +1,4 @@
-import { a as normalizeFormAuthoringConfig, i as isValidSimpleFormConfig, l as createSurveyAssistantCapabilities } from "./form-authoring-DCd9XfXf.mjs";
+import { a as normalizeFormAuthoringConfig, i as isValidSimpleFormConfig, l as createSurveyAssistantCapabilities } from "./form-authoring-BQh40yDb.mjs";
 import { ValueType } from "@case-framework/survey-core";
 //#region src/capabilities/default.ts
 const COMMON_OPERATIONS = [

package/dist/{constants-DrGZXtQf.d.mts → constants-DbrJxxOh.d.mts}

@@ -1,7 +1,8 @@
 import { Ct as SurveyDocumentSnapshot, o as SurveyAssistantApplyOutcome, wt as SurveyDocumentVersion } from "./lifecycle-DWv5CiSu.mjs";
-import { Bt as SurveyAssistantCapabilitySet, Et as SurveyAssistantEngineContext, y as TurnSurveyDraft } from "./index-Bo4dHAo8.mjs";
+import { Ut as SurveyAssistantCapabilitySet, b as TurnSurveyDraft, kt as SurveyAssistantEngineContext } from "./index-Da_Hb9-1.mjs";
 import { n as SurveyAssistantModelAttachment, t as SurveyAssistantAttachmentAccess } from "./thread-documents-Dvo6XS7o.mjs";
 import { RequestContext } from "@mastra/core/request-context";
+import { AgentExecutionOptions } from "@mastra/core/agent";
 import { OpenAICompatibleConfig } from "@mastra/core/llm";
 
 //#region src/server/request-context.d.ts
@@ -17,6 +18,8 @@ interface SurveyAssistantIdentityContext {
 interface SurveyAssistantModelSelection {
   id: string;
   model: string | OpenAICompatibleConfig;
+  providerName?: string;
+  providerOptions?: AgentExecutionOptions["providerOptions"];
 }
 type SurveyAssistantDocumentTransition = {
   status: "no-baseline";
@@ -96,4 +99,4 @@ declare const SURVEY_ASSISTANT_AGENT_ID = "survey-assistant-agent";
 declare const SURVEY_ASSISTANT_TASK_AGENT_ID = "survey-assistant-task-agent";
 //#endregion
 export { SurveyAssistantModelSelection as a, deriveSurveyAssistantDocumentTransition as c, parseSurveyAssistantSnapshot as d, requireSurveyAssistantTurnState as f, SurveyAssistantIdentityContext as i, parseSurveyAssistantPreviousApplyOutcome as l, SURVEY_ASSISTANT_TASK_AGENT_ID as n, SurveyAssistantRequestContext as o, SurveyAssistantDocumentTransition as r, buildSurveyAssistantRequestContext as s, SURVEY_ASSISTANT_AGENT_ID as t, parseSurveyAssistantPreviousSettledVersion as u };
-//# sourceMappingURL=constants-DrGZXtQf.d.mts.map
+//# sourceMappingURL=constants-DbrJxxOh.d.mts.map

package/dist/constants-DbrJxxOh.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DbrJxxOh.d.mts","names":[],"sources":["../src/server/request-context.ts","../src/server/constants.ts"],"mappings":";;;;;;;;UA2BiB,gCAAA;EACf,IAAA;AAAA;AAAA,UAGe,8BAAA;EACf,SAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;AAAA;AAAA,UAGe,6BAAA;EACf,EAAA;EACA,KAAA,WAAgB,sBAAA;EAChB,YAAA;EACA,eAAA,GAAkB,qBAAA;AAAA;AAAA,KAGR,iCAAA;EACN,MAAA;AAAA;EAEA,MAAA;EACA,oBAAA;EACA,mBAAA;AAAA;EAGA,MAAA;EACA,oBAAA;EACA,mBAAA;EACA,mBAAA;AAAA;EAGA,MAAA;EACA,oBAAA;EACA,mBAAA;EACA,gBAAA;EACA,eAAA,EAAiB,KAAA;EACjB,mBAAA;AAAA;AAAA,UAGW,6BAAA;EACf,UAAA,EAAY,gCAAA;EACZ,MAAA;EACA,SAAA,EAAW,eAAA;EACX,QAAA,EAAU,8BAAA;EACV,uBAAA;EACA,kBAAA;EACA,WAAA;EACA,kBAAA;EACA,gBAAA;EACA,kBAAA,GAAqB,iCAAA;EACrB,aAAA,GAAgB,4BAAA;EAChB,gBAAA,GAAmB,sBAAA;EACnB,gBAAA,GAAmB,8BAAA;EACnB,gBAAA,GAAmB,+BAAA;EACnB,cAAA,GAAiB,6BAAA;EACjB,oBAAA,GAAuB,2BAAA;AAAA;AAAA,cAGZ,4BAAA,GAAgC,KAAA,cAAiB,sBAAA;AAAA,cAQjD,0CAAA,GACX,KAAA,cACC,qBAAA;AAAA,cAQU,wCAAA,GACX,KAAA,cACC,2BAAA;AAAA,cAQU,uCAAA;EAA2C,OAAA;EAAA;AAAA;EAItD,OAAA,EAAS,sBAAA;EACT,QAAA,EAAU,qBAAA;AAAA,MACR,iCAAA;AAAA,cAqDS,kCAAA;EAAsC,SAAA;EAAA,QAAA;EAAA,QAAA;EAAA,sBAAA;EAAA,mBAAA;EAAA,gBAAA;EAAA,gBAAA;EAAA,cAAA;EAAA;AAAA;EAWjD,SAAA,EAAW,eAAA;EACX,QAAA,EAAU,8BAAA;EACV,QAAA,EAAU,sBAAA;EACV,sBAAA,GAAyB,qBAAA;EACzB,mBAAA,GAAsB,4BAAA;EACtB,gBAAA,GAAmB,+BAAA;EACnB,gBAAA,GAAmB,8BAAA;EACnB,cAAA,GAAiB,6BAAA;EACjB,oBAAA,GAAuB,2BAAA;AAAA,MACrB,cAAA,CAAe,6BAAA;AAAA,cAuDN,+BAAA,GACX,cAAA,EAAgB,cAAA,CAAe,6BAAA;;;;;;cCzPpB,yBAAA;AAAA,cACA,8BAAA"}

package/dist/{controller-proxy-DmBdzqKs.d.mts → controller-proxy-BdKF2yrq.d.mts}

@@ -1,4 +1,4 @@
-import { L as SurveyAssistantThread, c as SurveyAssistantSuggestItemKeyInput, d as SurveyAssistantSuggestItemLabelResult, l as SurveyAssistantSuggestItemKeyResult, m as SurveyAssistantTaskInvocationMode, p as SurveyAssistantTaskContext, u as SurveyAssistantSuggestItemLabelInput, v as SurveyAssistantTranslateContentInput, y as SurveyAssistantTranslateContentResult } from "./index-D4OitUg4.mjs";
+import { L as SurveyAssistantThread, c as SurveyAssistantSuggestItemKeyInput, d as SurveyAssistantSuggestItemLabelResult, l as SurveyAssistantSuggestItemKeyResult, m as SurveyAssistantTaskInvocationMode, p as SurveyAssistantTaskContext, u as SurveyAssistantSuggestItemLabelInput, v as SurveyAssistantTranslateContentInput, y as SurveyAssistantTranslateContentResult } from "./index-BApnIiCI.mjs";
 import { Tt as SurveyEditorUIContext, h as SurveyChangeSet, i as SurveyApplyResult, m as SurveyBatchApplyResult, xt as SurveyAssistantSnapshot } from "./lifecycle-DWv5CiSu.mjs";
 import { FileUIPart } from "ai";
 
@@ -82,4 +82,4 @@ declare const createSurveyAssistantControllerProxy: (getController: () => Survey
 declare const createSurveyAssistantControllerBridge: (options?: CreateSurveyAssistantControllerProxyOptions) => SurveyAssistantControllerBridge;
 //#endregion
 export { createSurveyAssistantThreadLauncher as _, SurveyAssistantController as a, SurveyAssistantTaskExecutionOptions as c, SurveyAssistantTaskExecutorRequestOptions as d, createSurveyAssistantTaskClient as f, SurveyAssistantThreadLauncher as g, SurveyAssistantThreadLaunch as h, createSurveyAssistantControllerProxy as i, SurveyAssistantTaskExecutor as l, SurveyAssistantLaunchUIContext as m, SurveyAssistantControllerBridge as n, SurveyAssistantTaskClient as o, createSurveyAssistantTaskExecutor as p, createSurveyAssistantControllerBridge as r, SurveyAssistantTaskClientOptions as s, CreateSurveyAssistantControllerProxyOptions as t, SurveyAssistantTaskExecutorCacheContext as u };
-//# sourceMappingURL=controller-proxy-DmBdzqKs.d.mts.map
+//# sourceMappingURL=controller-proxy-BdKF2yrq.d.mts.map

package/dist/{controller-proxy-DmBdzqKs.d.mts.map → controller-proxy-BdKF2yrq.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"controller-proxy-DmBdzqKs.d.mts","names":[],"sources":["../src/react/thread-launcher.ts","../src/react/task-client.ts","../src/react/controller.ts","../src/react/controller-proxy.ts"],"mappings":";;;;;KAOY,8BAAA,GAAiC,OAAA,CAAQ,IAAA,CAAK,qBAAA;AAAA,UAEzC,2BAAA;;EAEf,MAAA;EACA,KAAA,GAAQ,UAAA;;EAER,OAAA;EAPmD;EASnD,KAAA;EATkD;EAWlD,SAAA,GAAY,8BAAA;AAAA;AAAA,UAGG,6BAAA;EAdyC;;;AAE1D;EAiBE,WAAA,CAAY,KAAA,EAAO,2BAAA,GAA8B,OAAA,CAAQ,qBAAA;AAAA;AAAA,cA6D9C,mCAAA,QAA0C,6BAAA;;;UCxEtC,gCAAA;EACf,GAAA;EACA,UAAA;EACA,UAAA;EACA,QAAA;AAAA;AAAA,UAGe,mCAAA;EACf,IAAA,GAAO,iCAAA;EACP,OAAA;EACA,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,yBAAA;EACf,cAAA,CACE,KAAA,EAAO,kCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,mCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,qCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,qCAAA;AAAA;AAAA,UAGI,yCAAA;EACf,IAAA,GAAO,iCAAA;EACP,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,uCAAA;EACf,UAAA;AAAA;AAAA,UAGe,2BAAA;EACf,cAAA,CACE,KAAA,EAAO,kCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,mCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,qCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,qCAAA;AAAA;AAAA,cAGA,+BAAA;EAAmC,GAAA;EAAA,UAAA;EAAA,UAAA;EAAA;AAAA,IAK7C,gCAAA,KAAwC,yBAAA;AAAA,cA8C9B,iCAAA,GACX,OAAA,GAAS,gCAAA,KACR,2BAAA;;;UC1Hc,yBAAA;EACf,WAAA,IAAe,uBAAA;EACf,oBAAA,EAAsB,MAAA,EAAQ,eAAA,GAAkB,iBAAA;EAChD,qBAAA,EAAuB,OAAA,EAAS,eAAA,KAAoB,sBAAA;AAAA;;;UCPrC,2CAAA;EACf,eAAA;AAAA;AAAA,UAGe,+BAAA;EACf,UAAA,EAAY,yBAAA;EACZ,aAAA,CAAc,UAAA,EAAY,yBAAA;AAAA;AAAA,cAWf,oCAAA,GACX,aAAA,QAAqB,yBAAA;EACrB;AAAA,IAEG,2CAAA,KACF,yBAAA;AAAA,cAUU,qCAAA,GACX,OAAA,GAAU,2CAAA,KACT,+BAAA"}
+{"version":3,"file":"controller-proxy-BdKF2yrq.d.mts","names":[],"sources":["../src/react/thread-launcher.ts","../src/react/task-client.ts","../src/react/controller.ts","../src/react/controller-proxy.ts"],"mappings":";;;;;KAOY,8BAAA,GAAiC,OAAA,CAAQ,IAAA,CAAK,qBAAA;AAAA,UAEzC,2BAAA;;EAEf,MAAA;EACA,KAAA,GAAQ,UAAA;;EAER,OAAA;EAPmD;EASnD,KAAA;EATkD;EAWlD,SAAA,GAAY,8BAAA;AAAA;AAAA,UAGG,6BAAA;EAdyC;;;AAE1D;EAiBE,WAAA,CAAY,KAAA,EAAO,2BAAA,GAA8B,OAAA,CAAQ,qBAAA;AAAA;AAAA,cA6D9C,mCAAA,QAA0C,6BAAA;;;UCxEtC,gCAAA;EACf,GAAA;EACA,UAAA;EACA,UAAA;EACA,QAAA;AAAA;AAAA,UAGe,mCAAA;EACf,IAAA,GAAO,iCAAA;EACP,OAAA;EACA,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,yBAAA;EACf,cAAA,CACE,KAAA,EAAO,kCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,mCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,qCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,mCAAA,GACT,OAAA,CAAQ,qCAAA;AAAA;AAAA,UAGI,yCAAA;EACf,IAAA,GAAO,iCAAA;EACP,MAAA,GAAS,WAAA;AAAA;AAAA,UAGM,uCAAA;EACf,UAAA;AAAA;AAAA,UAGe,2BAAA;EACf,cAAA,CACE,KAAA,EAAO,kCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,mCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,qCAAA;EACX,gBAAA,CACE,KAAA,EAAO,oCAAA,EACP,OAAA,EAAS,0BAAA,EACT,OAAA,GAAU,yCAAA,EACV,KAAA,GAAQ,uCAAA,GACP,OAAA,CAAQ,qCAAA;AAAA;AAAA,cAGA,+BAAA;EAAmC,GAAA;EAAA,UAAA;EAAA,UAAA;EAAA;AAAA,IAK7C,gCAAA,KAAwC,yBAAA;AAAA,cA8C9B,iCAAA,GACX,OAAA,GAAS,gCAAA,KACR,2BAAA;;;UC1Hc,yBAAA;EACf,WAAA,IAAe,uBAAA;EACf,oBAAA,EAAsB,MAAA,EAAQ,eAAA,GAAkB,iBAAA;EAChD,qBAAA,EAAuB,OAAA,EAAS,eAAA,KAAoB,sBAAA;AAAA;;;UCPrC,2CAAA;EACf,eAAA;AAAA;AAAA,UAGe,+BAAA;EACf,UAAA,EAAY,yBAAA;EACZ,aAAA,CAAc,UAAA,EAAY,yBAAA;AAAA;AAAA,cAWf,oCAAA,GACX,aAAA,QAAqB,yBAAA;EACrB;AAAA,IAEG,2CAAA,KACF,yBAAA;AAAA,cAUU,qCAAA,GACX,OAAA,GAAU,2CAAA,KACT,+BAAA"}

package/dist/{controller-proxy-CpkQRezb.mjs → controller-proxy-jWIPOZAv.mjs}

@@ -1,24 +1,33 @@
-import { O as surveyAssistantTranslateContentResultSchema, b as surveyAssistantSuggestItemLabelResultSchema, jt as parseSurveyAssistantError, v as surveyAssistantSuggestItemKeyResultSchema } from "./protocol-DATvkr1S.mjs";
+import { O as surveyAssistantTranslateContentResultSchema, b as surveyAssistantSuggestItemLabelResultSchema, jt as parseSurveyAssistantError, v as surveyAssistantSuggestItemKeyResultSchema } from "./protocol-DJUP4gc0.mjs";
 //#region src/react/client-error.ts
 var SurveyAssistantClientError = class extends Error {
 	code;
-	constructor(code, message) {
+	retryable;
+	constructor(code, message, retryable = false) {
 		super(message);
 		this.name = "SurveyAssistantClientError";
 		this.code = code;
+		this.retryable = retryable;
 	}
 };
 const readSurveyAssistantJson = async (response, fallback = "The assistant request could not be completed.") => {
-	const body = await response.json().catch(() => ({}));
 	if (!response.ok) {
-		const detail = typeof body?.error === "string" ? body.error : fallback;
-		const parsed = parseSurveyAssistantError(typeof body?.code === "string" ? {
+		const responseText = await response.text().catch(() => "");
+		let body;
+		try {
+			body = responseText ? JSON.parse(responseText) : void 0;
+		} catch {
+			body = void 0;
+		}
+		const detail = typeof body === "object" && body !== null && "error" in body && typeof body.error === "string" ? body.error : responseText.trim() || fallback;
+		const parsed = parseSurveyAssistantError(typeof body === "object" && body !== null && "code" in body && typeof body.code === "string" ? {
 			code: body.code,
 			detail
 		} : detail);
-		throw new SurveyAssistantClientError(parsed.code, parsed.detail ?? detail);
+		const retryable = (typeof body === "object" && body !== null && "retryable" in body && typeof body.retryable === "boolean" ? body.retryable : void 0) ?? (parsed.code === "rate_limited" || (parsed.code === "request_failed" || parsed.code === "attachment_unavailable") && response.status >= 500);
+		throw new SurveyAssistantClientError(parsed.code, parsed.detail ?? detail, retryable);
 	}
-	return body;
+	return response.json().catch(() => ({}));
 };
 //#endregion
 //#region src/react/thread-launcher.ts
@@ -159,4 +168,4 @@ const createSurveyAssistantControllerBridge = (options) => {
 //#endregion
 export { applySurveyAssistantLaunchUIContext as a, SurveyAssistantClientError as c, createSurveyAssistantTaskExecutor as i, readSurveyAssistantJson as l, createSurveyAssistantControllerProxy as n, connectSurveyAssistantThreadLauncher as o, createSurveyAssistantTaskClient as r, createSurveyAssistantThreadLauncher as s, createSurveyAssistantControllerBridge as t };
 
-//# sourceMappingURL=controller-proxy-CpkQRezb.mjs.map
+//# sourceMappingURL=controller-proxy-jWIPOZAv.mjs.map

package/dist/controller-proxy-jWIPOZAv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-proxy-jWIPOZAv.mjs","names":[],"sources":["../src/react/client-error.ts","../src/react/thread-launcher.ts","../src/react/task-client.ts","../src/react/controller-proxy.ts"],"sourcesContent":["import { parseSurveyAssistantError, type SurveyAssistantErrorCode } from \"../protocol\";\n\nexport class SurveyAssistantClientError extends Error {\n  readonly code: SurveyAssistantErrorCode;\n  readonly retryable: boolean;\n\n  constructor(code: SurveyAssistantErrorCode, message: string, retryable = false) {\n    super(message);\n    this.name = \"SurveyAssistantClientError\";\n    this.code = code;\n    this.retryable = retryable;\n  }\n}\n\nexport const readSurveyAssistantJson = async (\n  response: Response,\n  fallback = \"The assistant request could not be completed.\",\n) => {\n  if (!response.ok) {\n    const responseText = await response.text().catch(() => \"\");\n    let body: unknown;\n    try {\n      body = responseText ? JSON.parse(responseText) : undefined;\n    } catch {\n      body = undefined;\n    }\n    const detail =\n      typeof body === \"object\" &&\n      body !== null &&\n      \"error\" in body &&\n      typeof body.error === \"string\"\n        ? body.error\n        : responseText.trim() || fallback;\n    const parsed = parseSurveyAssistantError(\n      typeof body === \"object\" &&\n        body !== null &&\n        \"code\" in body &&\n        typeof body.code === \"string\"\n        ? { code: body.code, detail }\n        : detail,\n    );\n    const explicitRetryable =\n      typeof body === \"object\" &&\n      body !== null &&\n      \"retryable\" in body &&\n      typeof body.retryable === \"boolean\"\n        ? body.retryable\n        : undefined;\n    const retryable =\n      explicitRetryable ??\n      (parsed.code === \"rate_limited\" ||\n        ((parsed.code === \"request_failed\" || parsed.code === \"attachment_unavailable\") &&\n          response.status >= 500));\n    throw new SurveyAssistantClientError(parsed.code, parsed.detail ?? detail, retryable);\n  }\n  return response.json().catch(() => ({}));\n};\n","import type {\n  SurveyAssistantSnapshot,\n  SurveyAssistantThread,\n  SurveyEditorUIContext,\n} from \"../protocol\";\nimport type { FileUIPart } from \"ai\";\n\nexport type SurveyAssistantLaunchUIContext = Partial<Omit<SurveyEditorUIContext, \"history\">>;\n\nexport interface SurveyAssistantThreadLaunch {\n  /** User-visible prompt submitted as the first message in the new thread. */\n  prompt: string;\n  files?: FileUIPart[];\n  /** Optional model used for the opening assistant turn. */\n  modelId?: string;\n  /** Optional manual thread title. The prompt-derived automatic title is used by default. */\n  title?: string;\n  /** Turn-local editor context merged into the snapshot captured when the prompt is submitted. */\n  uiContext?: SurveyAssistantLaunchUIContext;\n}\n\nexport interface SurveyAssistantThreadLauncher {\n  /**\n   * Creates a new thread and submits its first prompt when a connected panel is ready.\n   * Calls made before the panel mounts are queued.\n   */\n  startThread(input: SurveyAssistantThreadLaunch): Promise<SurveyAssistantThread>;\n}\n\ntype LaunchHandler = (input: SurveyAssistantThreadLaunch) => Promise<SurveyAssistantThread>;\n\ninterface PendingLaunch {\n  input: SurveyAssistantThreadLaunch;\n  reject(error: unknown): void;\n  resolve(thread: SurveyAssistantThread): void;\n}\n\ninterface LauncherState {\n  handler: LaunchHandler | null;\n  pending: PendingLaunch[];\n  draining: boolean;\n}\n\nconst launcherStates = new WeakMap<SurveyAssistantThreadLauncher, LauncherState>();\n\nexport const applySurveyAssistantLaunchUIContext = (\n  snapshot: SurveyAssistantSnapshot | null,\n  uiContext: SurveyAssistantLaunchUIContext | undefined,\n): SurveyAssistantSnapshot | null =>\n  snapshot && uiContext\n    ? {\n        ...snapshot,\n        ui: {\n          ...snapshot.ui,\n          ...uiContext,\n        },\n      }\n    : snapshot;\n\nconst getLauncherState = (launcher: SurveyAssistantThreadLauncher) => {\n  const state = launcherStates.get(launcher);\n  if (!state) {\n    throw new Error(\n      \"The survey assistant thread launcher was not created by createSurveyAssistantThreadLauncher.\",\n    );\n  }\n  return state;\n};\n\nconst drainPendingLaunches = async (state: LauncherState) => {\n  if (state.draining) return;\n  state.draining = true;\n  try {\n    while (state.handler && state.pending.length > 0) {\n      const pending = state.pending.shift();\n      if (!pending) continue;\n      try {\n        pending.resolve(await state.handler(pending.input));\n      } catch (error) {\n        pending.reject(error);\n      }\n    }\n  } finally {\n    state.draining = false;\n  }\n};\n\nexport const createSurveyAssistantThreadLauncher = (): SurveyAssistantThreadLauncher => {\n  const state: LauncherState = { handler: null, pending: [], draining: false };\n  const launcher: SurveyAssistantThreadLauncher = {\n    startThread(input) {\n      const prompt = input.prompt.trim();\n      if (!prompt && (input.files?.length ?? 0) === 0) {\n        return Promise.reject(new Error(\"A survey assistant prompt or attachment is required.\"));\n      }\n\n      return new Promise((resolve, reject) => {\n        state.pending.push({\n          input: {\n            ...input,\n            prompt,\n            ...(input.files ? { files: [...input.files] } : {}),\n            ...(input.modelId ? { modelId: input.modelId.trim() } : {}),\n            ...(input.title ? { title: input.title.trim() } : {}),\n          },\n          reject,\n          resolve,\n        });\n        void drainPendingLaunches(state);\n      });\n    },\n  };\n  launcherStates.set(launcher, state);\n  return launcher;\n};\n\nexport const connectSurveyAssistantThreadLauncher = (\n  launcher: SurveyAssistantThreadLauncher,\n  handler: LaunchHandler,\n) => {\n  const state = getLauncherState(launcher);\n  if (state.handler && state.handler !== handler) {\n    throw new Error(\"A survey assistant thread launcher can only control one mounted panel.\");\n  }\n  state.handler = handler;\n  void drainPendingLaunches(state);\n\n  return () => {\n    if (state.handler === handler) state.handler = null;\n  };\n};\n","import {\n  surveyAssistantSuggestItemKeyResultSchema,\n  surveyAssistantSuggestItemLabelResultSchema,\n  surveyAssistantTranslateContentResultSchema,\n  type SurveyAssistantSuggestItemKeyInput,\n  type SurveyAssistantSuggestItemKeyResult,\n  type SurveyAssistantSuggestItemLabelInput,\n  type SurveyAssistantSuggestItemLabelResult,\n  type SurveyAssistantTaskContext,\n  type SurveyAssistantTaskInvocationMode,\n  type SurveyAssistantTranslateContentInput,\n  type SurveyAssistantTranslateContentResult,\n} from \"../protocol\";\nimport { readSurveyAssistantJson } from \"./client-error\";\n\nexport interface SurveyAssistantTaskClientOptions {\n  api?: string;\n  getModelId?: () => string | undefined;\n  resourceId?: string;\n  surveyId?: string;\n}\n\nexport interface SurveyAssistantTaskExecutionOptions {\n  mode?: SurveyAssistantTaskInvocationMode;\n  modelId?: string;\n  signal?: AbortSignal;\n}\n\nexport interface SurveyAssistantTaskClient {\n  suggestItemKey(\n    input: SurveyAssistantSuggestItemKeyInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantSuggestItemKeyResult>;\n  suggestItemLabel(\n    input: SurveyAssistantSuggestItemLabelInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantSuggestItemLabelResult>;\n  translateContent(\n    input: SurveyAssistantTranslateContentInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ): Promise<SurveyAssistantTranslateContentResult>;\n}\n\nexport interface SurveyAssistantTaskExecutorRequestOptions {\n  mode?: SurveyAssistantTaskInvocationMode;\n  signal?: AbortSignal;\n}\n\nexport interface SurveyAssistantTaskExecutorCacheContext {\n  cacheScope?: string;\n}\n\nexport interface SurveyAssistantTaskExecutor {\n  suggestItemKey(\n    input: SurveyAssistantSuggestItemKeyInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutorRequestOptions,\n    cache?: SurveyAssistantTaskExecutorCacheContext,\n  ): Promise<SurveyAssistantSuggestItemKeyResult>;\n  suggestItemLabel(\n    input: SurveyAssistantSuggestItemLabelInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutorRequestOptions,\n    cache?: SurveyAssistantTaskExecutorCacheContext,\n  ): Promise<SurveyAssistantSuggestItemLabelResult>;\n  translateContent(\n    input: SurveyAssistantTranslateContentInput,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutorRequestOptions,\n    cache?: SurveyAssistantTaskExecutorCacheContext,\n  ): Promise<SurveyAssistantTranslateContentResult>;\n}\n\nexport const createSurveyAssistantTaskClient = ({\n  api = \"/api/survey-assistant/tasks\",\n  getModelId,\n  resourceId,\n  surveyId,\n}: SurveyAssistantTaskClientOptions = {}): SurveyAssistantTaskClient => {\n  const run = async (\n    taskId: \"suggest-item-key\" | \"suggest-item-label\" | \"translate-content\",\n    input: unknown,\n    context: SurveyAssistantTaskContext,\n    options?: SurveyAssistantTaskExecutionOptions,\n  ) => {\n    const modelId = options?.modelId ?? getModelId?.();\n    return readSurveyAssistantJson(\n      await fetch(api, {\n        body: JSON.stringify({\n          taskId,\n          input,\n          context,\n          ...(options?.mode ? { mode: options.mode } : {}),\n          ...(modelId ? { modelId } : {}),\n          ...(resourceId ? { resourceId } : {}),\n          ...(surveyId ? { surveyId } : {}),\n        }),\n        headers: { \"content-type\": \"application/json\" },\n        method: \"POST\",\n        signal: options?.signal,\n      }),\n      \"The survey assistant task could not be completed.\",\n    );\n  };\n\n  return {\n    async suggestItemKey(input, context, options) {\n      return surveyAssistantSuggestItemKeyResultSchema.parse(\n        await run(\"suggest-item-key\", input, context, options),\n      );\n    },\n    async suggestItemLabel(input, context, options) {\n      return surveyAssistantSuggestItemLabelResultSchema.parse(\n        await run(\"suggest-item-label\", input, context, options),\n      );\n    },\n    async translateContent(input, context, options) {\n      return surveyAssistantTranslateContentResultSchema.parse(\n        await run(\"translate-content\", input, context, options),\n      );\n    },\n  };\n};\n\nexport const createSurveyAssistantTaskExecutor = (\n  options: SurveyAssistantTaskClientOptions = {},\n): SurveyAssistantTaskExecutor => {\n  const client = createSurveyAssistantTaskClient(options);\n  const executionOptions = (\n    request?: SurveyAssistantTaskExecutorRequestOptions,\n    cache?: SurveyAssistantTaskExecutorCacheContext,\n  ): SurveyAssistantTaskExecutionOptions => ({\n    mode: request?.mode,\n    modelId: cache?.cacheScope,\n    signal: request?.signal,\n  });\n\n  return {\n    suggestItemKey: (input, context, request, cache) =>\n      client.suggestItemKey(input, context, executionOptions(request, cache)),\n    suggestItemLabel: (input, context, request, cache) =>\n      client.suggestItemLabel(input, context, executionOptions(request, cache)),\n    translateContent: (input, context, request, cache) =>\n      client.translateContent(input, context, executionOptions(request, cache)),\n  };\n};\n","import type { SurveyApplyResult, SurveyBatchApplyResult, SurveyChangeSet } from \"../protocol\";\nimport type { SurveyAssistantController } from \"./controller\";\n\nexport interface CreateSurveyAssistantControllerProxyOptions {\n  notReadyMessage?: string;\n}\n\nexport interface SurveyAssistantControllerBridge {\n  controller: SurveyAssistantController;\n  setController(controller: SurveyAssistantController | null | undefined): void;\n}\n\nconst failedResult = (change: SurveyChangeSet, message: string): SurveyApplyResult => ({\n  status: \"failed\",\n  changeId: change.id,\n  summary: change.summary,\n  message,\n  appliedOperations: 0,\n});\n\nexport const createSurveyAssistantControllerProxy = (\n  getController: () => SurveyAssistantController | null | undefined,\n  {\n    notReadyMessage = \"The survey editor is not ready.\",\n  }: CreateSurveyAssistantControllerProxyOptions = {},\n): SurveyAssistantController => ({\n  getSnapshot: () => getController()?.getSnapshot() ?? null,\n  applyAssistantChange: (change) =>\n    getController()?.applyAssistantChange?.(change) ?? failedResult(change, notReadyMessage),\n  applyAssistantChanges: (changes): SurveyBatchApplyResult =>\n    getController()?.applyAssistantChanges?.(changes) ?? {\n      results: changes.map((change) => failedResult(change, notReadyMessage)),\n    },\n});\n\nexport const createSurveyAssistantControllerBridge = (\n  options?: CreateSurveyAssistantControllerProxyOptions,\n): SurveyAssistantControllerBridge => {\n  let currentController: SurveyAssistantController | null | undefined;\n  return {\n    controller: createSurveyAssistantControllerProxy(() => currentController, options),\n    setController(controller) {\n      currentController = controller;\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/{engine-CWTuN3o2.mjs → engine-DcSdLRle.mjs}

@@ -1,13 +1,13 @@
-import { I as rawSurveyDocumentSchema, f as surveyChangeSetSchema, l as surveyAssistantTurnFinalSchema } from "./protocol-DATvkr1S.mjs";
-import { a as normalizeFormAuthoringConfig, c as assertSurveyAssistantCapabilities, i as isValidSimpleFormConfig, o as transitionFormAuthoringMode, r as isCompatibleSimpleFieldUpsert, t as getFormAuthoringMode } from "./form-authoring-DCd9XfXf.mjs";
+import { I as rawSurveyDocumentSchema, f as surveyChangeSetSchema, l as surveyAssistantTurnFinalSchema } from "./protocol-DJUP4gc0.mjs";
+import { a as normalizeFormAuthoringConfig, c as assertSurveyAssistantCapabilities, i as isValidSimpleFormConfig, o as transitionFormAuthoringMode, r as isCompatibleSimpleFieldUpsert, t as getFormAuthoringMode } from "./form-authoring-BQh40yDb.mjs";
 import { z } from "zod";
-import { ContentType, Expression, ExpressionType, FunctionExpressionNames, JsonPatchError, ReservedSurveyItemTypes, SurveyItemTranslations, SurveyTranslations, ValueReferenceMethod, ValueType, applyJsonPatch, generateId, getContentPlainText, isContentEmpty, parseJsonPointer, structuredCloneMethod } from "@case-framework/survey-core";
+import { ContentType, Expression, ExpressionType, FunctionExpressionNames, JsonPatchError, ReservedSurveyItemTypes, SurveyItemTranslations, SurveyTranslations, ValueReference, ValueReferenceMethod, ValueType, analyzeSurveyExpressionReferences, applyJsonPatch, findIntroducedExpressionReferenceDiagnostics, generateId, getContentPlainText, isContentEmpty, parseJsonPointer, structuredCloneMethod } from "@case-framework/survey-core";
 //#region src/engine/context.ts
-const isRecord$6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord$7 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const asString$1 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 const asArray$1 = (value) => Array.isArray(value) ? value : [];
 const getChildIds = (item) => {
-	return asArray$1((isRecord$6(item.config) ? item.config : void 0)?.items).filter((entry) => typeof entry === "string");
+	return asArray$1((isRecord$7(item.config) ? item.config : void 0)?.items).filter((entry) => typeof entry === "string");
 };
 const getFieldValueType = (field) => {
 	switch (field.type) {
@@ -23,8 +23,8 @@ const addResponseSlot = (lookup, itemId, slotId, valueType) => {
 	lookup[`${itemId}...${ValueReferenceMethod.isDefined}...${slotId}`] = ValueType.boolean;
 };
 const addFormResponseSlots = ({ config, itemId, lookup, slotPrefix }) => {
-	if (!isRecord$6(config)) return;
-	for (const group of asArray$1(config.fieldGroups).filter(isRecord$6)) for (const field of asArray$1(group.fields).filter(isRecord$6)) {
+	if (!isRecord$7(config)) return;
+	for (const group of asArray$1(config.fieldGroups).filter(isRecord$7)) for (const field of asArray$1(group.fields).filter(isRecord$7)) {
 		const key = asString$1(field.key);
 		if (!key) continue;
 		addResponseSlot(lookup, itemId, slotPrefix ? `${slotPrefix}.${key}` : key, getFieldValueType(field));
@@ -39,10 +39,10 @@ const deriveResponseSlotTypes = (survey, trustedCapabilities) => {
 			continue;
 		}
 		if (item.itemType === "choiceItem") {
-			const config = isRecord$6(item.config) ? item.config : {};
+			const config = isRecord$7(item.config) ? item.config : {};
 			const slotId = asString$1(config.id) ?? item.id;
 			addResponseSlot(lookup, item.id, slotId, config.maxSelection === 1 ? ValueType.reference : ValueType.referenceArray);
-			for (const option of asArray$1(config.options).filter(isRecord$6)) {
+			for (const option of asArray$1(config.options).filter(isRecord$7)) {
 				const optionId = asString$1(option.id);
 				if (optionId && option.embeddedForm) addFormResponseSlots({
 					config: option.embeddedForm,
@@ -98,7 +98,7 @@ const buildDerivedContext = (snapshot, trustedCapabilities, requestedFocusItemId
 		});
 		for (const childId of getChildIds(item)) visit(childId, depth + 1);
 	};
-	const explicitRoot = rawItems.find((item) => isRecord$6(item.config) && item.config.isRoot === true);
+	const explicitRoot = rawItems.find((item) => isRecord$7(item.config) && item.config.isRoot === true);
 	if (explicitRoot) visit(explicitRoot.id, 0);
 	for (const item of [...rawItems].sort((left, right) => left.id.localeCompare(right.id))) if (!visited.has(item.id)) visit(item.id, 0);
 	const keyIndex = outline.map((node) => ({
@@ -455,6 +455,36 @@ const validateExpression = ({ expression, expectedReturnType, issues, operationI
 	}));
 };
 //#endregion
+//#region src/engine/expression-reference-integrity.ts
+const isRecord$6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const choiceAllowedValues = (survey, ref) => {
+	let parsed;
+	try {
+		parsed = new ValueReference(ref);
+	} catch {
+		return;
+	}
+	if (parsed.name !== ValueReferenceMethod.get) return void 0;
+	const item = survey.surveyItems.find((candidate) => candidate.id === parsed.itemId);
+	if (item?.itemType !== "choiceItem" || !isRecord$6(item.config)) return void 0;
+	const slotId = typeof item.config.id === "string" ? item.config.id : item.id;
+	if (parsed.slotId !== slotId || !Array.isArray(item.config.options)) return void 0;
+	return item.config.options.flatMap((option) => isRecord$6(option) && typeof option.id === "string" ? [option.id] : []);
+};
+const deriveSurveyExpressionResponseSlots = (survey, trustedCapabilities) => Object.entries(deriveResponseSlotTypes(survey, trustedCapabilities)).flatMap(([ref, valueType]) => {
+	if (!valueType) return [];
+	const allowedReferenceValues = valueType === ValueType.reference || valueType === ValueType.referenceArray ? choiceAllowedValues(survey, ref) : void 0;
+	return [{
+		ref,
+		valueType,
+		...allowedReferenceValues ? { allowedReferenceValues } : {}
+	}];
+});
+const analyzeSurveyAssistantExpressionReferences = (survey, trustedCapabilities) => analyzeSurveyExpressionReferences({
+	survey,
+	responseSlots: deriveSurveyExpressionResponseSlots(survey, trustedCapabilities)
+});
+//#endregion
 //#region src/engine/inspection.ts
 const DEFAULT_LIMIT = 12;
 const MAX_LIMIT = 50;
@@ -2469,6 +2499,17 @@ const validateSurveyTreeStructure = (survey, operationId, availableItemTypes) =>
 	}
 	return issues;
 };
+const collectIntroducedExpressionIntegrityIssues = ({ after, before, operationId, operationIndex = 0, snapshot }) => findIntroducedExpressionReferenceDiagnostics({
+	before: analyzeSurveyAssistantExpressionReferences(before, snapshot.trustedCapabilities),
+	after: analyzeSurveyAssistantExpressionReferences(after, snapshot.trustedCapabilities)
+}).map((diagnostic) => createIssue({
+	severity: "warning",
+	code: diagnostic.code,
+	message: `${diagnostic.message}${diagnostic.candidates?.length ? ` Available replacements include: ${diagnostic.candidates.join(", ")}.` : ""} Update or clear every affected expression in the same assistant turn; the editor will reject the final batch while this remains unresolved.`,
+	operationIndex,
+	operationId,
+	itemId: diagnostic.ownerItemId
+}));
 const validateSurveyJsonPatchOperation = ({ operation, snapshot }) => {
 	const operationId = getOperationId(operation);
 	const issues = [];
@@ -2564,6 +2605,12 @@ const validateSurveyJsonPatchOperation = ({ operation, snapshot }) => {
 			operationId
 		}));
 	}
+	warnings.push(...collectIntroducedExpressionIntegrityIssues({
+		after: patchedSurvey,
+		before: snapshot.survey,
+		operationId,
+		snapshot
+	}));
 	if (getRawItemsFromSurvey(patchedSurvey).length !== getRawSurveyItems(snapshot).length) warnings.push(createIssue({
 		severity: "warning",
 		code: "raw-patch-changed-item-count",
@@ -4627,6 +4674,23 @@ const validateSurveyOperations = ({ maxOperations = 200, operations, snapshot: s
 			}
 		}
 	});
+	if (issues.length === 0) try {
+		const prospectiveSurvey = applyValidatedSurveyOperationsToDraft({
+			operations: normalizedOperations,
+			survey: snapshot.survey
+		});
+		warnings.push(...collectIntroducedExpressionIntegrityIssues({
+			after: prospectiveSurvey,
+			before: snapshot.survey,
+			operationIndex: Math.max(0, normalizedOperations.length - 1),
+			snapshot
+		}));
+	} catch (error) {
+		issues.push(createIssue({
+			code: "expression-integrity-check-failed",
+			message: `The resulting survey could not be checked for expression integrity: ${error instanceof Error ? error.message : String(error)}`
+		}));
+	}
 	return {
 		valid: issues.length === 0,
 		issues,
@@ -5106,6 +5170,11 @@ const QUALITY_PRINCIPLES = [
 		title: "Response option quality",
 		prompt: "Are options mutually exclusive, collectively sufficient, balanced, ordered, and consistently scaled?"
 	},
+	{
+		id: "key-semantic-consistency",
+		title: "Coding-key consistency",
+		prompt: "Do item, option, and field keys follow the survey's established convention and avoid contradicting the content they currently identify? Generic, numeric, or opaque keys are acceptable when that is the survey's consistent pattern; flag descriptive keys when they have become stale or misleading, and mixed conventions when the inconsistency appears accidental."
+	},
 	{
 		id: "flow",
 		title: "Flow and completeness",
@@ -5143,6 +5212,75 @@ const translationText = (context, locale, itemId, contentKey) => {
 	const content = (isRecord$1(itemTranslations?.[itemId]) ? itemTranslations[itemId] : void 0)?.[contentKey];
 	return content ? getContentPlainText(content).trim() : "";
 };
+const summarizeItemContent = (context, locale, item) => {
+	if (!locale) return {};
+	const itemContent = context.survey.translations?.[locale]?.itemTranslations?.[item.id];
+	if (!isRecord$1(itemContent)) return {};
+	for (const contentKey of [
+		"title",
+		"content",
+		"subtitle",
+		"topContent",
+		"bottomContent"
+	]) {
+		const content = itemContent[contentKey];
+		if (!content) continue;
+		const text = getContentPlainText(content).trim();
+		if (text) return {
+			contentKey,
+			content: text
+		};
+	}
+	return {};
+};
+const collectKeyReviewEntries = (context, sourceLocale) => {
+	const entries = [];
+	const addFormFields = (item, groups, contentPrefix) => {
+		for (const group of groups) for (const field of records(group.fields)) {
+			if (typeof field.id !== "string" || typeof field.key !== "string") continue;
+			const contentKey = `${contentPrefix}fields.${field.id}.label`;
+			const content = sourceLocale ? translationText(context, sourceLocale, item.id, contentKey) : "";
+			entries.push({
+				kind: "form-field",
+				itemId: item.id,
+				itemKey: item.key,
+				key: field.key,
+				keySource: "explicit",
+				contentKey,
+				...content ? { content } : {}
+			});
+		}
+	};
+	for (const item of context.survey.surveyItems) {
+		entries.push({
+			kind: "item",
+			itemId: item.id,
+			itemKey: item.key,
+			key: item.key,
+			keySource: "explicit",
+			...summarizeItemContent(context, sourceLocale, item)
+		});
+		const config = isRecord$1(item.config) ? item.config : {};
+		if (item.itemType === "choiceItem") for (const option of records(config.options)) {
+			if (typeof option.id !== "string") continue;
+			const explicitKey = typeof option.key === "string" && option.key.trim() ? option.key : null;
+			const contentKey = `options.${option.id}.label`;
+			const content = sourceLocale ? translationText(context, sourceLocale, item.id, contentKey) : "";
+			entries.push({
+				kind: "choice-option",
+				itemId: item.id,
+				itemKey: item.key,
+				key: explicitKey ?? option.id,
+				keySource: explicitKey ? "explicit" : "fallback-id",
+				contentKey,
+				...content ? { content } : {}
+			});
+			if (option.embeddedForm) addFormFields(item, getGroups(item, option.id), `embeddedForms.${option.id}.`);
+		}
+		else if (item.itemType === "formItem") addFormFields(item, getGroups(item), "");
+	}
+	return entries;
+};
 const getGroups = (item, optionId) => {
 	const config = isRecord$1(item.config) ? item.config : {};
 	if (!optionId) return records(config.fieldGroups);
@@ -5221,6 +5359,10 @@ const auditSurvey = (context, options = {}) => {
 	const locales = context.inspection.locales;
 	const sourceLocale = options.sourceLocale ?? context.ui.selectedLocale ?? locales[0];
 	const targetLocales = options.targetLocales ?? locales.filter((locale) => locale !== sourceLocale);
+	const allKeyReviewEntries = collectKeyReviewEntries(context, sourceLocale);
+	const keyReviewOffset = Math.min(options.keyReviewOffset ?? 0, allKeyReviewEntries.length);
+	const keyReviewLimit = options.keyReviewLimit ?? 30;
+	const keyReviewEntries = allKeyReviewEntries.slice(keyReviewOffset, keyReviewOffset + keyReviewLimit);
 	const manifests = new Map(context.capabilities.itemTypes.map((entry) => [entry.itemType, entry]));
 	for (const item of items) {
 		const manifest = manifests.get(item.itemType);
@@ -5309,6 +5451,15 @@ const auditSurvey = (context, options = {}) => {
 			});
 		}
 	}
+	for (const diagnostic of analyzeSurveyAssistantExpressionReferences(context.survey, context.trustedCapabilities)) add({
+		code: diagnostic.code,
+		severity: "error",
+		category: "logic",
+		message: diagnostic.message,
+		...diagnostic.ownerItemId ? { itemId: diagnostic.ownerItemId } : {},
+		contentKey: diagnostic.location,
+		suggestion: diagnostic.candidates && diagnostic.candidates.length > 0 ? `Use one of the valid current references: ${diagnostic.candidates.join(", ")}.` : "Inspect the current response slots and expression location before repairing it."
+	});
 	const assets = context.survey.assets ?? {};
 	for (const [assetId, asset] of Object.entries(assets)) {
 		const metadata = isRecord$1(asset.metadata) ? asset.metadata : {};
@@ -5343,6 +5494,15 @@ const auditSurvey = (context, options = {}) => {
 		},
 		findings: limited,
 		qualityReviewPrinciples: QUALITY_PRINCIPLES,
+		keyReview: {
+			sourceLocale,
+			entryCount: allKeyReviewEntries.length,
+			offset: keyReviewOffset,
+			returnedEntryCount: keyReviewEntries.length,
+			truncated: keyReviewOffset + keyReviewEntries.length < allKeyReviewEntries.length,
+			entries: keyReviewEntries,
+			note: "These key/content pairs are evidence for qualitative review, not deterministic defects. Judge them against the survey's own naming pattern; generic or opaque keys are not inherently problematic."
+		},
 		note: "Technical findings are deterministic. Quality principles are a structured review rubric; apply them with human/model judgment and domain context, and do not present them as psychometric validation."
 	};
 };
@@ -5864,6 +6024,6 @@ var SurveyAssistantTaskResultCache = class {
 	}
 };
 //#endregion
-export { deriveResponseSlotTypes as $, getRawSurvey$1 as A, resolveItemSummary as B, clampLimit as C, formFieldGroupLayoutSchema as D, formFieldGroupDetailsSchema as E, mapKeyIndexById as F, summarizeKeyIndexEntry as G, summarizeFocusItemNode as H, mapOutlineById as I, translationEntrySchema as J, summarizeOutlineNode as K, mapRawItemsById as L, itemConfigDetailsSchema as M, itemMatchesQuery as N, formSelectOptionDetailsSchema as O, itemSummarySchema as P, createSurveyAssistantEngineContext as Q, normalizeText as R, choiceOptionDetailsSchema as S, formFieldDetailsSchema as T, summarizeItemById as U, sliceWithCursor as V, summarizeKeyIndexEntries as W, inferExpressionReturnType as X, unique as Y, validateExpression as Z, buildConfigSearchText as _, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as a, buildItemTranslationEntries as b, buildSurveyDocumentVersion as c, normalizeSurveyChangeOperations as d, buildExpressionMutationPatches as f, MAX_LIMIT as g, DEFAULT_LIMIT as h, auditSurvey as i, getRawSurveyItems as j, getKeyIndexEntries as k, createSurveyChangeSet as l, expressionSchema as m, buildSurveyAssistantTaskContext as n, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT as o, expressionMutationSchema as p, summarizeRawItem as q, TurnSurveyDraft as r, applyValidatedSurveyOperationsToDraft as s, SurveyAssistantTaskResultCache as t, validateSurveyOperations as u, buildEmbeddedFormDetails as v, findDirectChildrenByFullKey as w, buildSurveyTranslations as x, buildItemConfigDetails as y, parseCursor as z };
+export { validateExpression as $, getRawSurvey$1 as A, resolveItemSummary as B, clampLimit as C, formFieldGroupLayoutSchema as D, formFieldGroupDetailsSchema as E, mapKeyIndexById as F, summarizeKeyIndexEntry as G, summarizeFocusItemNode as H, mapOutlineById as I, translationEntrySchema as J, summarizeOutlineNode as K, mapRawItemsById as L, itemConfigDetailsSchema as M, itemMatchesQuery as N, formSelectOptionDetailsSchema as O, itemSummarySchema as P, inferExpressionReturnType as Q, normalizeText as R, choiceOptionDetailsSchema as S, formFieldDetailsSchema as T, summarizeItemById as U, sliceWithCursor as V, summarizeKeyIndexEntries as W, analyzeSurveyAssistantExpressionReferences as X, unique as Y, deriveSurveyExpressionResponseSlots as Z, buildConfigSearchText as _, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as a, buildItemTranslationEntries as b, buildSurveyDocumentVersion as c, normalizeSurveyChangeOperations as d, createSurveyAssistantEngineContext as et, buildExpressionMutationPatches as f, MAX_LIMIT as g, DEFAULT_LIMIT as h, auditSurvey as i, getRawSurveyItems as j, getKeyIndexEntries as k, createSurveyChangeSet as l, expressionSchema as m, buildSurveyAssistantTaskContext as n, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT as o, expressionMutationSchema as p, summarizeRawItem as q, TurnSurveyDraft as r, applyValidatedSurveyOperationsToDraft as s, SurveyAssistantTaskResultCache as t, deriveResponseSlotTypes as tt, validateSurveyOperations as u, buildEmbeddedFormDetails as v, findDirectChildrenByFullKey as w, buildSurveyTranslations as x, buildItemConfigDetails as y, parseCursor as z };
 
-//# sourceMappingURL=engine-CWTuN3o2.mjs.map
+//# sourceMappingURL=engine-DcSdLRle.mjs.map