@case-framework/survey-assistant 0.3.0 → 0.4.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,

package/dist/capabilities-default.d.mts

@@ -1,4 +1,4 @@
-import { Bt as SurveyAssistantCapabilitySet, It as AssistantItemCapabilityAdapter } from "./index-Bo4dHAo8.mjs";
+import { Ht as SurveyAssistantCapabilitySet, Rt as AssistantItemCapabilityAdapter } from "./index-r8HVcn5b.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-k1b_evIb.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 { Ht as SurveyAssistantCapabilitySet, Ot as SurveyAssistantEngineContext, y as TurnSurveyDraft } from "./index-r8HVcn5b.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-k1b_evIb.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants-k1b_evIb.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-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":";;AAEA,IAAa,6BAAb,cAAgD,MAAM;CACpD;CACA;CAEA,YAAY,MAAgC,SAAiB,YAAY,OAAO;AAC9E,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,YAAY;;;AAIrB,MAAa,0BAA0B,OACrC,UACA,WAAW,oDACR;AACH,KAAI,CAAC,SAAS,IAAI;EAChB,MAAM,eAAe,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;EAC1D,IAAI;AACJ,MAAI;AACF,UAAO,eAAe,KAAK,MAAM,aAAa,GAAG,KAAA;UAC3C;AACN,UAAO,KAAA;;EAET,MAAM,SACJ,OAAO,SAAS,YAChB,SAAS,QACT,WAAW,QACX,OAAO,KAAK,UAAU,WAClB,KAAK,QACL,aAAa,MAAM,IAAI;EAC7B,MAAM,SAAS,0BACb,OAAO,SAAS,YACd,SAAS,QACT,UAAU,QACV,OAAO,KAAK,SAAS,WACnB;GAAE,MAAM,KAAK;GAAM;GAAQ,GAC3B,OACL;EAQD,MAAM,aANJ,OAAO,SAAS,YAChB,SAAS,QACT,eAAe,QACf,OAAO,KAAK,cAAc,YACtB,KAAK,YACL,KAAA,OAGH,OAAO,SAAS,mBACb,OAAO,SAAS,oBAAoB,OAAO,SAAS,6BACpD,SAAS,UAAU;AACzB,QAAM,IAAI,2BAA2B,OAAO,MAAM,OAAO,UAAU,QAAQ,UAAU;;AAEvF,QAAO,SAAS,MAAM,CAAC,aAAa,EAAE,EAAE;;;;ACZ1C,MAAM,iCAAiB,IAAI,SAAuD;AAElF,MAAa,uCACX,UACA,cAEA,YAAY,YACR;CACE,GAAG;CACH,IAAI;EACF,GAAG,SAAS;EACZ,GAAG;EACJ;CACF,GACD;AAEN,MAAM,oBAAoB,aAA4C;CACpE,MAAM,QAAQ,eAAe,IAAI,SAAS;AAC1C,KAAI,CAAC,MACH,OAAM,IAAI,MACR,+FACD;AAEH,QAAO;;AAGT,MAAM,uBAAuB,OAAO,UAAyB;AAC3D,KAAI,MAAM,SAAU;AACpB,OAAM,WAAW;AACjB,KAAI;AACF,SAAO,MAAM,WAAW,MAAM,QAAQ,SAAS,GAAG;GAChD,MAAM,UAAU,MAAM,QAAQ,OAAO;AACrC,OAAI,CAAC,QAAS;AACd,OAAI;AACF,YAAQ,QAAQ,MAAM,MAAM,QAAQ,QAAQ,MAAM,CAAC;YAC5C,OAAO;AACd,YAAQ,OAAO,MAAM;;;WAGjB;AACR,QAAM,WAAW;;;AAIrB,MAAa,4CAA2E;CACtF,MAAM,QAAuB;EAAE,SAAS;EAAM,SAAS,EAAE;EAAE,UAAU;EAAO;CAC5E,MAAM,WAA0C,EAC9C,YAAY,OAAO;EACjB,MAAM,SAAS,MAAM,OAAO,MAAM;AAClC,MAAI,CAAC,WAAW,MAAM,OAAO,UAAU,OAAO,EAC5C,QAAO,QAAQ,uBAAO,IAAI,MAAM,uDAAuD,CAAC;AAG1F,SAAO,IAAI,SAAS,SAAS,WAAW;AACtC,SAAM,QAAQ,KAAK;IACjB,OAAO;KACL,GAAG;KACH;KACA,GAAI,MAAM,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,MAAM,EAAE,GAAG,EAAE;KAClD,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,MAAM,EAAE,GAAG,EAAE;KAC1D,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,MAAM,EAAE,GAAG,EAAE;KACrD;IACD;IACA;IACD,CAAC;AACG,wBAAqB,MAAM;IAChC;IAEL;AACD,gBAAe,IAAI,UAAU,MAAM;AACnC,QAAO;;AAGT,MAAa,wCACX,UACA,YACG;CACH,MAAM,QAAQ,iBAAiB,SAAS;AACxC,KAAI,MAAM,WAAW,MAAM,YAAY,QACrC,OAAM,IAAI,MAAM,yEAAyE;AAE3F,OAAM,UAAU;AACX,sBAAqB,MAAM;AAEhC,cAAa;AACX,MAAI,MAAM,YAAY,QAAS,OAAM,UAAU;;;;;ACpDnD,MAAa,mCAAmC,EAC9C,MAAM,+BACN,YACA,YACA,aACoC,EAAE,KAAgC;CACtE,MAAM,MAAM,OACV,QACA,OACA,SACA,YACG;EACH,MAAM,UAAU,SAAS,WAAW,cAAc;AAClD,SAAO,wBACL,MAAM,MAAM,KAAK;GACf,MAAM,KAAK,UAAU;IACnB;IACA;IACA;IACA,GAAI,SAAS,OAAO,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;IAC/C,GAAI,UAAU,EAAE,SAAS,GAAG,EAAE;IAC9B,GAAI,aAAa,EAAE,YAAY,GAAG,EAAE;IACpC,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;IACjC,CAAC;GACF,SAAS,EAAE,gBAAgB,oBAAoB;GAC/C,QAAQ;GACR,QAAQ,SAAS;GAClB,CAAC,EACF,oDACD;;AAGH,QAAO;EACL,MAAM,eAAe,OAAO,SAAS,SAAS;AAC5C,UAAO,0CAA0C,MAC/C,MAAM,IAAI,oBAAoB,OAAO,SAAS,QAAQ,CACvD;;EAEH,MAAM,iBAAiB,OAAO,SAAS,SAAS;AAC9C,UAAO,4CAA4C,MACjD,MAAM,IAAI,sBAAsB,OAAO,SAAS,QAAQ,CACzD;;EAEH,MAAM,iBAAiB,OAAO,SAAS,SAAS;AAC9C,UAAO,4CAA4C,MACjD,MAAM,IAAI,qBAAqB,OAAO,SAAS,QAAQ,CACxD;;EAEJ;;AAGH,MAAa,qCACX,UAA4C,EAAE,KACd;CAChC,MAAM,SAAS,gCAAgC,QAAQ;CACvD,MAAM,oBACJ,SACA,WACyC;EACzC,MAAM,SAAS;EACf,SAAS,OAAO;EAChB,QAAQ,SAAS;EAClB;AAED,QAAO;EACL,iBAAiB,OAAO,SAAS,SAAS,UACxC,OAAO,eAAe,OAAO,SAAS,iBAAiB,SAAS,MAAM,CAAC;EACzE,mBAAmB,OAAO,SAAS,SAAS,UAC1C,OAAO,iBAAiB,OAAO,SAAS,iBAAiB,SAAS,MAAM,CAAC;EAC3E,mBAAmB,OAAO,SAAS,SAAS,UAC1C,OAAO,iBAAiB,OAAO,SAAS,iBAAiB,SAAS,MAAM,CAAC;EAC5E;;;;ACvIH,MAAM,gBAAgB,QAAyB,aAAwC;CACrF,QAAQ;CACR,UAAU,OAAO;CACjB,SAAS,OAAO;CAChB;CACA,mBAAmB;CACpB;AAED,MAAa,wCACX,eACA,EACE,kBAAkB,sCAC6B,EAAE,MACpB;CAC/B,mBAAmB,eAAe,EAAE,aAAa,IAAI;CACrD,uBAAuB,WACrB,eAAe,EAAE,uBAAuB,OAAO,IAAI,aAAa,QAAQ,gBAAgB;CAC1F,wBAAwB,YACtB,eAAe,EAAE,wBAAwB,QAAQ,IAAI,EACnD,SAAS,QAAQ,KAAK,WAAW,aAAa,QAAQ,gBAAgB,CAAC,EACxE;CACJ;AAED,MAAa,yCACX,YACoC;CACpC,IAAI;AACJ,QAAO;EACL,YAAY,2CAA2C,mBAAmB,QAAQ;EAClF,cAAc,YAAY;AACxB,uBAAoB;;EAEvB"}

package/dist/{controller-proxy-DmBdzqKs.d.mts → controller-proxy-quQjtA7j.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-8x1Eqlnz.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-quQjtA7j.d.mts.map

package/dist/{controller-proxy-DmBdzqKs.d.mts.map → controller-proxy-quQjtA7j.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-quQjtA7j.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/{engine-CWTuN3o2.mjs → engine-BvfUx_Jx.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,
@@ -5309,6 +5373,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 : {};
@@ -5864,6 +5937,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-BvfUx_Jx.mjs.map