@case-framework/survey-assistant 0.1.0 → 0.2.0

package/dist/server-tasks.mjs

@@ -1,6 +1,7 @@
-import { C as surveyAssistantTaskRequestSchema } from "./protocol-DV0ka9WT.mjs";
+import { C as surveyAssistantTaskRequestSchema } from "./protocol-7EEgcYja.mjs";
 import { n as SURVEY_ASSISTANT_TASK_AGENT_ID } from "./constants-CFUWrRtl.mjs";
-import { n as surveyAuthoringReferences } from "./authoring-references-X6uRaWuf.mjs";
+import { d as readSurveyAssistantRequestJson, u as SurveyAssistantRequestError } from "./request-guardrails-h4t6u8mP.mjs";
+import { r as surveyAuthoringReferences } from "./authoring-references-DYuOAdVx.mjs";
 import { z } from "zod";
 import { RequestContext } from "@mastra/core/request-context";
 import { Agent } from "@mastra/core/agent";
@@ -68,6 +69,27 @@ const translationsSchema = z.object({ translations: z.record(z.string(), z.recor
 const clampLimit = (value, fallback, maximum) => Math.min(Math.max(1, value ?? fallback), maximum);
 const sanitizeCodingKey = (value) => value.trim().replace(/[.\s-]+/g, "_").replace(/[^A-Za-z0-9_]+/g, "_").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
 const getCodingKeyIdentity = (value) => sanitizeCodingKey(value).toLocaleLowerCase();
+const getNumberedKeyParts = (value) => {
+	const match = /^(.+?)_(\d+)$/.exec(getCodingKeyIdentity(value));
+	return match ? {
+		stem: match[1],
+		number: Number(match[2])
+	} : void 0;
+};
+const isUnsupportedFocusedItemSequence = (candidate, input, context) => {
+	const candidateParts = getNumberedKeyParts(candidate);
+	const focusItem = context.focus?.item;
+	if (!candidateParts || !focusItem) return false;
+	if (![
+		input.currentKey,
+		input.draftKey,
+		focusItem.key
+	].map(getNumberedKeyParts).find((parts) => parts?.stem === candidateParts.stem && parts.number < candidateParts.number)) return false;
+	return !context.naming?.keyExamples.some((example) => {
+		const exampleParts = getNumberedKeyParts(example.key);
+		return example.itemType === focusItem.itemType && exampleParts?.stem === candidateParts.stem;
+	});
+};
 const invocationInstruction = (mode) => mode === "background" ? "This is a background invocation. Be efficient, but do not relax task conventions, completeness, or output quality." : "This is an explicit user invocation. Prioritize quality and useful variation.";
 const runSurveyAssistantSuggestItemKeyTask = async (input, options) => {
 	const maxSuggestions = Math.min(Math.max(4, input.maxSuggestions ?? 6), 6);
@@ -79,9 +101,11 @@ const runSurveyAssistantSuggestItemKeyTask = async (input, options) => {
 		instructions: [
 			"Generate coding keys for the focused survey item, not editor labels or respondent-facing text.",
 			"Infer the dominant topic from the focused item's visible text, descendants, hierarchy, and draft key.",
+			"For a group or other container, treat its own descendants as the primary evidence for what the container represents. Derive a descriptive group key from those children before considering generic default container names.",
 			"The input currentKey and draftKey, plus the focused item's key and fullKey in currentSurveyContext, identify the value being replaced. They may provide topic hints, but they are not evidence of an established naming or numbering pattern.",
 			"Use only currentSurveyContext.naming.keyExamples and sibling keys from other items to infer the survey's established naming pattern. Pay particular attention to prefixes, casing, separators, numeric sequences, and zero padding.",
 			"Treat a numeric pattern as established only when at least one other survey item supports it. For example, another item Q1_APPLES can support a topic-appropriate Q2_... key, while Q1_APPLES and Q2_ORANGES support Q3_.... The focused item's current key choice_1 by itself does not support choice_2 or a numeric suffix in other suggestions.",
+			"In particular, a focused group named group_1 is a default placeholder, not a group-numbering pattern. Do not propose group_2 (or another group_N key) from it unless another group/container in currentSurveyContext.naming.keyExamples independently uses the same group_N pattern. The group's children provide semantic context, not evidence of a group-numbering pattern.",
 			"Return one surveyPattern key that follows the strongest detected local pattern. Preserve that pattern's casing and increment a clear sequence rather than copying an existing number. If no meaningful pattern exists, use a consistent descriptive key.",
 			"Return one compact key: a recognizable 2-5 character uppercase abbreviation using only A-Z and digits.",
 			"Return one preferred key: the key you consider clearest and most useful without category-specific naming constraints, while still using only letters, digits, and underscores.",
@@ -116,7 +140,7 @@ const runSurveyAssistantSuggestItemKeyTask = async (input, options) => {
 	].flatMap((suggestion) => {
 		const text = sanitizeCodingKey(suggestion.text);
 		const identity = getCodingKeyIdentity(text);
-		if (!text || excluded.has(identity) || seen.has(identity)) return [];
+		if (!text || excluded.has(identity) || seen.has(identity) || isUnsupportedFocusedItemSequence(text, input, options.context)) return [];
 		seen.add(identity);
 		return [{
 			...suggestion,
@@ -194,58 +218,91 @@ const runSurveyAssistantTranslateContentTask = async (input, options) => {
 	return { translations };
 };
 const MAX_TASK_REQUEST_BYTES = 512 * 1024;
+const DEFAULT_MAX_TASK_CONCURRENT_REQUESTS = 4;
+const DEFAULT_MAX_TASK_DURATION_MS = 6e4;
 const taskErrorResponse = (error) => {
-	const status = typeof error === "object" && error !== null && "status" in error && typeof error.status === "number" ? error.status : 400;
-	const message = error instanceof Error ? error.message : "The survey assistant task could not be completed.";
+	const status = typeof error === "object" && error !== null && "status" in error && typeof error.status === "number" ? error.status : error instanceof SyntaxError || error instanceof Error && error.name === "ZodError" ? 400 : 500;
+	const message = error instanceof SurveyAssistantRequestError ? error.message : status === 401 || status === 403 || status === 404 ? status === 404 ? "Survey assistant task not found." : "The survey assistant task is not authorized." : status >= 500 ? "The survey assistant task could not be completed." : "The survey assistant task request is invalid.";
 	return Response.json({
-		code: status === 401 || status === 403 ? "authorization_failed" : "request_failed",
+		code: status === 401 || status === 403 || status === 404 ? "authorization_failed" : "request_failed",
 		error: message
 	}, { status });
 };
-const createSurveyAssistantTaskHandler = ({ agent, authorize, getReadinessError, isEnabled, providerOptions, resolveModel }) => async (request) => {
-	try {
-		if (isEnabled && !await isEnabled(request)) return Response.json({
-			code: "request_failed",
-			error: "Survey assistant is disabled."
-		}, { status: 404 });
-		const identity = await authorize(request);
-		if (!identity?.resourceId?.trim()) throw Object.assign(/* @__PURE__ */ new Error("The host returned an invalid task identity."), { status: 500 });
-		const readinessError = await getReadinessError?.(request);
-		if (readinessError) return Response.json({
-			code: "request_failed",
-			error: readinessError
-		}, { status: 503 });
-		const text = await request.text();
-		if (new TextEncoder().encode(text).byteLength > MAX_TASK_REQUEST_BYTES) return Response.json({
-			code: "request_failed",
-			error: "The survey assistant task request is too large."
-		}, { status: 413 });
-		const task = surveyAssistantTaskRequestSchema.parse(JSON.parse(text));
-		const requestContext = new RequestContext();
-		if (resolveModel) {
-			const modelSelection = await resolveModel({
-				identity,
+const createSurveyAssistantTaskHandler = ({ agent, authorize, getReadinessError, isEnabled, maxConcurrentRequests = DEFAULT_MAX_TASK_CONCURRENT_REQUESTS, maxDurationMs = DEFAULT_MAX_TASK_DURATION_MS, onTaskMetrics, providerOptions, resolveModel }) => {
+	const concurrency = Number.isInteger(maxConcurrentRequests) && maxConcurrentRequests > 0 ? maxConcurrentRequests : DEFAULT_MAX_TASK_CONCURRENT_REQUESTS;
+	const duration = Number.isFinite(maxDurationMs) && maxDurationMs > 0 ? maxDurationMs : DEFAULT_MAX_TASK_DURATION_MS;
+	let activeRequests = 0;
+	return async (request) => {
+		if (activeRequests >= concurrency) return Response.json({
+			code: "rate_limited",
+			error: "The survey assistant is handling too many tasks. Try again shortly."
+		}, { status: 429 });
+		activeRequests += 1;
+		const startedAt = Date.now();
+		let metricsIdentity;
+		let metricsTaskId = "unknown";
+		let completed = false;
+		try {
+			if (isEnabled && !await isEnabled(request)) return Response.json({
+				code: "request_failed",
+				error: "Survey assistant is disabled."
+			}, { status: 404 });
+			const task = surveyAssistantTaskRequestSchema.parse(await readSurveyAssistantRequestJson(request, MAX_TASK_REQUEST_BYTES));
+			metricsTaskId = task.taskId;
+			const identity = await authorize({
 				request,
-				requestedModelId: task.modelId
+				requestedResourceId: task.resourceId,
+				requestedSurveyId: task.surveyId
 			});
-			if (!modelSelection) return Response.json({
+			if (!identity?.resourceId?.trim() || identity.resourceId.trim().length > 240 || identity.surveyId !== void 0 && (!identity.surveyId.trim() || identity.surveyId.trim().length > 240)) throw Object.assign(/* @__PURE__ */ new Error("The host returned an invalid task identity."), { status: 500 });
+			metricsIdentity = {
+				resourceId: identity.resourceId.trim(),
+				...identity.surveyId?.trim() ? { surveyId: identity.surveyId.trim() } : {}
+			};
+			const readinessError = await getReadinessError?.(request);
+			if (readinessError) return Response.json({
 				code: "request_failed",
-				error: "The selected survey assistant model is unavailable."
-			}, { status: 400 });
-			requestContext.set("modelSelection", modelSelection);
+				error: readinessError
+			}, { status: 503 });
+			const requestContext = new RequestContext();
+			if (resolveModel) {
+				const modelSelection = await resolveModel({
+					identity: metricsIdentity,
+					request,
+					requestedModelId: task.modelId
+				});
+				if (!modelSelection) return Response.json({
+					code: "request_failed",
+					error: "The selected survey assistant model is unavailable."
+				}, { status: 400 });
+				requestContext.set("modelSelection", modelSelection);
+			}
+			const resolvedAgent = typeof agent === "function" ? await agent() : agent;
+			const runtime = {
+				abortSignal: AbortSignal.any([request.signal, AbortSignal.timeout(duration)]),
+				agent: resolvedAgent,
+				context: task.context,
+				mode: task.mode,
+				requestContext,
+				providerOptions
+			};
+			const result = task.taskId === "suggest-item-key" ? await runSurveyAssistantSuggestItemKeyTask(task.input, runtime) : task.taskId === "suggest-item-label" ? await runSurveyAssistantSuggestItemLabelTask(task.input, runtime) : await runSurveyAssistantTranslateContentTask(task.input, runtime);
+			completed = true;
+			return Response.json(result);
+		} catch (error) {
+			return taskErrorResponse(error);
+		} finally {
+			activeRequests = Math.max(0, activeRequests - 1);
+			if (metricsIdentity) try {
+				onTaskMetrics?.({
+					durationMs: Date.now() - startedAt,
+					identity: metricsIdentity,
+					status: completed ? "completed" : "failed",
+					taskId: metricsTaskId
+				});
+			} catch {}
 		}
-		const runtime = {
-			agent: typeof agent === "function" ? await agent() : agent,
-			context: task.context,
-			mode: task.mode,
-			requestContext,
-			providerOptions
-		};
-		const result = task.taskId === "suggest-item-key" ? await runSurveyAssistantSuggestItemKeyTask(task.input, runtime) : task.taskId === "suggest-item-label" ? await runSurveyAssistantSuggestItemLabelTask(task.input, runtime) : await runSurveyAssistantTranslateContentTask(task.input, runtime);
-		return Response.json(result);
-	} catch (error) {
-		return taskErrorResponse(error);
-	}
+	};
 };
 //#endregion
 export { createSurveyAssistantTaskAgent, createSurveyAssistantTaskHandler, runSurveyAssistantSuggestItemKeyTask, runSurveyAssistantSuggestItemLabelTask, runSurveyAssistantTask, runSurveyAssistantTranslateContentTask };

package/dist/server-tasks.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"server-tasks.mjs","names":[],"sources":["../src/server/tasks.ts"],"sourcesContent":["import { Agent, type AgentConfig, type AgentExecutionOptions } from \"@mastra/core/agent\";\nimport { RequestContext } from \"@mastra/core/request-context\";\nimport { z } from \"zod\";\nimport { surveyAssistantTaskRequestSchema } from \"../protocol\";\nimport type {\n  SurveyAssistantSuggestItemKeyInput,\n  SurveyAssistantSuggestItemKeyResult,\n  SurveyAssistantKeySuggestionCategory,\n  SurveyAssistantSuggestItemLabelInput,\n  SurveyAssistantSuggestItemLabelResult,\n  SurveyAssistantTaskInvocationMode,\n  SurveyAssistantTaskContext,\n  SurveyAssistantTranslateContentInput,\n  SurveyAssistantTranslateContentResult,\n} from \"../protocol\";\nimport {\n  surveyAuthoringReferences,\n  type SurveyAuthoringReferenceTopic,\n} from \"./authoring-references\";\nimport type {\n  SurveyAssistantModelSelection,\n  SurveyAssistantRequestContext,\n} from \"./request-context\";\nimport { SURVEY_ASSISTANT_TASK_AGENT_ID } from \"./constants\";\n\ntype SurveyAssistantTaskAgentConfig = AgentConfig<\n  typeof SURVEY_ASSISTANT_TASK_AGENT_ID,\n  Record<string, never>,\n  undefined,\n  SurveyAssistantRequestContext\n>;\n\nexport interface CreateSurveyAssistantTaskAgentOptions {\n  model: SurveyAssistantTaskAgentConfig[\"model\"];\n}\n\nexport const createSurveyAssistantTaskAgent = ({ model }: CreateSurveyAssistantTaskAgentOptions) =>\n  new Agent<\n    typeof SURVEY_ASSISTANT_TASK_AGENT_ID,\n    Record<string, never>,\n    undefined,\n    SurveyAssistantRequestContext\n  >({\n    id: SURVEY_ASSISTANT_TASK_AGENT_ID,\n    name: \"Survey Assistant Tasks\",\n    instructions:\n      \"Perform the supplied bounded survey-authoring task and return only its requested structured output.\",\n    model,\n  });\n\nexport interface RunSurveyAssistantTaskOptions<TSchema extends z.ZodType> {\n  agent: Pick<Agent, \"generate\">;\n  taskId: string;\n  input: unknown;\n  context: SurveyAssistantTaskContext;\n  schema: TSchema;\n  instructions: readonly string[];\n  referenceTopics?: readonly SurveyAuthoringReferenceTopic[];\n  requestContext?: RequestContext<SurveyAssistantRequestContext>;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  abortSignal?: AbortSignal;\n}\n\nconst BASE_TASK_INSTRUCTIONS = [\n  \"You perform one bounded CASE Survey Editor AI task and return only the requested structured result.\",\n  \"The supplied task context was derived from the current canonical survey document snapshot. Use it as current survey context, but do not mutate it and do not claim that any editor change was applied.\",\n  \"Follow the supplied CASE authoring references where relevant. Do not invent item types, locales, ids, or capabilities that are absent from the task input and context.\",\n  \"Keep generated respondent-facing wording neutral, concise, and consistent with the requested locale and surrounding survey content.\",\n] as const;\n\nexport const runSurveyAssistantTask = async <TSchema extends z.ZodType>({\n  agent,\n  taskId,\n  input,\n  context,\n  schema,\n  instructions,\n  referenceTopics = [],\n  requestContext,\n  providerOptions,\n  abortSignal,\n}: RunSurveyAssistantTaskOptions<TSchema>): Promise<z.output<TSchema>> => {\n  const references = referenceTopics.map((topic) => ({\n    topic,\n    title: surveyAuthoringReferences[topic].title,\n    content: surveyAuthoringReferences[topic].content,\n  }));\n  const response = await agent.generate(\n    JSON.stringify({ taskId, input, currentSurveyContext: context }),\n    {\n      instructions: [\n        ...BASE_TASK_INSTRUCTIONS,\n        ...instructions,\n        ...references.map((entry) => `Reference: ${entry.title}\\n${entry.content}`),\n      ],\n      activeTools: [],\n      inputProcessors: [],\n      maxSteps: 1,\n      structuredOutput: {\n        schema,\n        errorStrategy: \"strict\",\n      },\n      ...(requestContext ? { requestContext } : {}),\n      ...(providerOptions ? { providerOptions } : {}),\n      ...(abortSignal ? { abortSignal } : {}),\n    },\n  );\n\n  return schema.parse(response.object);\n};\n\nconst keySuggestionValueSchema = z.object({\n  text: z.string().min(1),\n  rationale: z.string().optional(),\n});\n\nconst keySuggestionCategorySchema = z.enum([\"survey-pattern\", \"compact\", \"preferred\", \"fair\"]);\n\nconst keySuggestionSchema = z.object({\n  surveyPattern: keySuggestionValueSchema.describe(\n    \"A key that follows the strongest naming and numbering pattern in the current survey.\",\n  ),\n  compact: keySuggestionValueSchema.extend({\n    text: z\n      .string()\n      .min(2)\n      .max(5)\n      .regex(/^[A-Z][A-Z0-9]{1,4}$/)\n      .describe(\"A recognizable 2-5 character uppercase abbreviation.\"),\n  }),\n  preferred: keySuggestionValueSchema.describe(\n    \"The key the model considers clearest without a category-specific naming constraint.\",\n  ),\n  fair: keySuggestionValueSchema.extend({\n    text: z\n      .string()\n      .min(1)\n      .max(32)\n      .regex(/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/)\n      .describe(\"A FAIR-by-design lowercase snake_case variable name.\"),\n  }),\n  alternatives: z\n    .array(\n      keySuggestionValueSchema.extend({\n        category: keySuggestionCategorySchema,\n      }),\n    )\n    .max(2),\n});\n\nconst labelSuggestionSchema = z.object({\n  suggestions: z.array(\n    z.object({\n      text: z.string().min(1),\n    }),\n  ),\n});\n\nconst translationsSchema = z.object({\n  translations: z.record(z.string(), z.record(z.string(), z.string())),\n});\n\nexport interface RunSurveyAssistantBuiltInTaskOptions {\n  agent: Pick<Agent, \"generate\">;\n  context: SurveyAssistantTaskContext;\n  mode?: SurveyAssistantTaskInvocationMode;\n  requestContext?: RequestContext<SurveyAssistantRequestContext>;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  abortSignal?: AbortSignal;\n}\n\nconst clampLimit = (value: number | undefined, fallback: number, maximum: number) =>\n  Math.min(Math.max(1, value ?? fallback), maximum);\n\nconst sanitizeCodingKey = (value: string) =>\n  value\n    .trim()\n    .replace(/[.\\s-]+/g, \"_\")\n    .replace(/[^A-Za-z0-9_]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\nconst getCodingKeyIdentity = (value: string) => sanitizeCodingKey(value).toLocaleLowerCase();\n\nconst invocationInstruction = (mode: SurveyAssistantTaskInvocationMode | undefined) =>\n  mode === \"background\"\n    ? \"This is a background invocation. Be efficient, but do not relax task conventions, completeness, or output quality.\"\n    : \"This is an explicit user invocation. Prioritize quality and useful variation.\";\n\nexport const runSurveyAssistantSuggestItemKeyTask = async (\n  input: SurveyAssistantSuggestItemKeyInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantSuggestItemKeyResult> => {\n  const maxSuggestions = Math.min(Math.max(4, input.maxSuggestions ?? 6), 6);\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"suggest-item-key\",\n    input,\n    schema: keySuggestionSchema,\n    instructions: [\n      \"Generate coding keys for the focused survey item, not editor labels or respondent-facing text.\",\n      \"Infer the dominant topic from the focused item's visible text, descendants, hierarchy, and draft key.\",\n      \"The input currentKey and draftKey, plus the focused item's key and fullKey in currentSurveyContext, identify the value being replaced. They may provide topic hints, but they are not evidence of an established naming or numbering pattern.\",\n      \"Use only currentSurveyContext.naming.keyExamples and sibling keys from other items to infer the survey's established naming pattern. Pay particular attention to prefixes, casing, separators, numeric sequences, and zero padding.\",\n      \"Treat a numeric pattern as established only when at least one other survey item supports it. For example, another item Q1_APPLES can support a topic-appropriate Q2_... key, while Q1_APPLES and Q2_ORANGES support Q3_.... The focused item's current key choice_1 by itself does not support choice_2 or a numeric suffix in other suggestions.\",\n      \"Return one surveyPattern key that follows the strongest detected local pattern. Preserve that pattern's casing and increment a clear sequence rather than copying an existing number. If no meaningful pattern exists, use a consistent descriptive key.\",\n      \"Return one compact key: a recognizable 2-5 character uppercase abbreviation using only A-Z and digits.\",\n      \"Return one preferred key: the key you consider clearest and most useful without category-specific naming constraints, while still using only letters, digits, and underscores.\",\n      \"Return one fair key following these FAIR-by-design rules: start with a letter; use lowercase ASCII letters, digits, and underscores only; use lowercase snake_case; stay at or below 32 characters; avoid programming/database reserved words; prefer a stable, language-neutral English concept name; use established instrument prefixes and sortable item numbers when applicable; distinguish raw from derived variables. Meaning belongs in metadata, so do not turn it into a sentence.\",\n      `You may return up to ${Math.max(0, maxSuggestions - 4)} genuinely useful alternatives when another category has more than one strong candidate. Tag each alternative with its category.`,\n      \"Never repeat the same suggestion, including case-only or punctuation-only variations.\",\n      \"Do not return the current key, a sibling key, or a semantically unrelated abbreviation.\",\n      `Return between 4 and ${maxSuggestions} distinct suggestions in total.`,\n      invocationInstruction(options.mode),\n    ],\n  });\n\n  const excluded = new Set(\n    [input.currentKey, ...input.siblingKeys].map(getCodingKeyIdentity).filter(Boolean),\n  );\n  const seen = new Set<string>();\n  const categorizedSuggestions: Array<{\n    text: string;\n    rationale?: string;\n    category: SurveyAssistantKeySuggestionCategory;\n  }> = [\n    { ...result.surveyPattern, category: \"survey-pattern\" },\n    { ...result.compact, category: \"compact\" },\n    { ...result.preferred, category: \"preferred\" },\n    { ...result.fair, category: \"fair\" },\n    ...result.alternatives,\n  ];\n  const suggestions = categorizedSuggestions\n    .flatMap((suggestion) => {\n      const text = sanitizeCodingKey(suggestion.text);\n      const identity = getCodingKeyIdentity(text);\n      if (!text || excluded.has(identity) || seen.has(identity)) return [];\n      seen.add(identity);\n      return [{ ...suggestion, text }];\n    })\n    .slice(0, maxSuggestions);\n  return { suggestions };\n};\n\nexport const runSurveyAssistantSuggestItemLabelTask = async (\n  input: SurveyAssistantSuggestItemLabelInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantSuggestItemLabelResult> => {\n  const maxSuggestions = clampLimit(input.maxSuggestions, 3, 10);\n  const locale = input.locale ?? options.context.survey.selectedLocale;\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"suggest-item-label\",\n    input,\n    schema: labelSuggestionSchema,\n    instructions: [\n      \"Suggest concise editor-only item labels, not coding keys and not respondent-facing question text.\",\n      \"Infer the item's purpose from its type, draft label, visible content, hierarchy, siblings, and descendants.\",\n      \"Use currentSurveyContext.naming.labelExamples to infer established capitalization, prefixes, abbreviations, delimiters, and typical length.\",\n      \"If existing label examples are available, the first suggestion must follow their dominant pattern while still describing the focused item accurately. Other suggestions may offer useful concise alternatives.\",\n      \"Do not copy the subject matter of an unrelated example merely to imitate its style, and do not return an existing unrelated label verbatim.\",\n      `Write labels in locale ${locale}.`,\n      `Return at most ${maxSuggestions} distinct, specific, human-readable suggestions.`,\n      invocationInstruction(options.mode),\n    ],\n    referenceTopics: [\"core-rules\"],\n  });\n\n  const normalizeLabel = (value: string) => value.trim().toLocaleLowerCase();\n  const excludedLabels = new Set([\n    normalizeLabel(input.draftLabel),\n    ...(options.context.naming?.labelExamples ?? []).map((example) =>\n      normalizeLabel(example.label),\n    ),\n  ]);\n  const seen = new Set<string>();\n  return {\n    suggestions: result.suggestions\n      .flatMap((suggestion) => {\n        const text = suggestion.text.trim();\n        const normalizedText = normalizeLabel(text);\n        if (!text || excludedLabels.has(normalizedText) || seen.has(normalizedText)) return [];\n        seen.add(normalizedText);\n        return [{ ...suggestion, text }];\n      })\n      .slice(0, maxSuggestions),\n  };\n};\n\nconst getProtectedTokens = (value: string) =>\n  value.match(/\\{\\{[^{}]+\\}\\}|\\{[^{}]+\\}|\\$\\{[^{}]+\\}|%\\d*\\$?[a-z]/gi) ?? [];\n\nexport const runSurveyAssistantTranslateContentTask = async (\n  input: SurveyAssistantTranslateContentInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantTranslateContentResult> => {\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"translate-content\",\n    input,\n    schema: translationsSchema,\n    instructions: [\n      \"Translate every supplied survey-content entry faithfully without adding explanations or omitting content.\",\n      `Translate from ${input.sourceLocale} into exactly these target locales: ${input.targetLocales.join(\", \")}.`,\n      \"Use currentSurveyContext.translation.examples as a terminology and style reference when relevant. The supplied source entries remain authoritative.\",\n      \"Preserve meaning, register, survey terminology, punctuation, line breaks, response semantics, placeholders, interpolation tokens, URLs, and identifiers that should not be translated.\",\n      \"Keep repeated terminology consistent across all entries and target locales. Do not use a neighboring translation when its meaning differs.\",\n      \"Return plain strings keyed first by target locale and then by the original entry id. Return every requested locale and entry exactly once.\",\n      invocationInstruction(options.mode),\n    ],\n    referenceTopics: [\"localization\"],\n  });\n\n  const translations: SurveyAssistantTranslateContentResult[\"translations\"] = {};\n  for (const locale of input.targetLocales) {\n    const entries = result.translations[locale];\n    if (!entries) throw new Error(`Translation result is missing locale ${locale}.`);\n    const translatedEntries: Record<string, string> = {};\n    for (const entry of input.entries) {\n      const translation = entries[entry.id];\n      if (typeof translation !== \"string\" || translation.trim().length === 0) {\n        throw new Error(`Translation result is missing entry ${entry.id} for locale ${locale}.`);\n      }\n      const sourceTokens = getProtectedTokens(entry.text).sort();\n      const translatedTokens = getProtectedTokens(translation).sort();\n      if (sourceTokens.join(\"\\u0000\") !== translatedTokens.join(\"\\u0000\")) {\n        throw new Error(\n          `Translation result changed protected tokens in entry ${entry.id} for locale ${locale}.`,\n        );\n      }\n      translatedEntries[entry.id] = translation;\n    }\n    translations[locale] = translatedEntries;\n  }\n  return { translations };\n};\n\nconst MAX_TASK_REQUEST_BYTES = 512 * 1024;\n\nexport interface SurveyAssistantTaskAuthorizedIdentity {\n  resourceId: string;\n}\n\nexport interface SurveyAssistantTaskModelResolutionInput {\n  identity: SurveyAssistantTaskAuthorizedIdentity;\n  request: Request;\n  requestedModelId?: string;\n}\n\nexport interface CreateSurveyAssistantTaskHandlerOptions {\n  agent:\n    | Pick<Agent, \"generate\">\n    | (() => Pick<Agent, \"generate\"> | Promise<Pick<Agent, \"generate\">>);\n  authorize(\n    request: Request,\n  ): SurveyAssistantTaskAuthorizedIdentity | Promise<SurveyAssistantTaskAuthorizedIdentity>;\n  getReadinessError?(request: Request): string | null | Promise<string | null>;\n  isEnabled?(request: Request): boolean | Promise<boolean>;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  resolveModel?(\n    input: SurveyAssistantTaskModelResolutionInput,\n  ):\n    | SurveyAssistantModelSelection\n    | null\n    | undefined\n    | Promise<SurveyAssistantModelSelection | null | undefined>;\n}\n\nconst taskErrorResponse = (error: unknown) => {\n  const status =\n    typeof error === \"object\" &&\n    error !== null &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n      ? error.status\n      : 400;\n  const message =\n    error instanceof Error ? error.message : \"The survey assistant task could not be completed.\";\n  return Response.json(\n    {\n      code: status === 401 || status === 403 ? \"authorization_failed\" : \"request_failed\",\n      error: message,\n    },\n    { status },\n  );\n};\n\nexport const createSurveyAssistantTaskHandler =\n  ({\n    agent,\n    authorize,\n    getReadinessError,\n    isEnabled,\n    providerOptions,\n    resolveModel,\n  }: CreateSurveyAssistantTaskHandlerOptions) =>\n  async (request: Request): Promise<Response> => {\n    try {\n      if (isEnabled && !(await isEnabled(request))) {\n        return Response.json(\n          { code: \"request_failed\", error: \"Survey assistant is disabled.\" },\n          { status: 404 },\n        );\n      }\n      const identity = await authorize(request);\n      if (!identity?.resourceId?.trim()) {\n        throw Object.assign(new Error(\"The host returned an invalid task identity.\"), {\n          status: 500,\n        });\n      }\n\n      const readinessError = await getReadinessError?.(request);\n      if (readinessError) {\n        return Response.json({ code: \"request_failed\", error: readinessError }, { status: 503 });\n      }\n\n      const text = await request.text();\n      if (new TextEncoder().encode(text).byteLength > MAX_TASK_REQUEST_BYTES) {\n        return Response.json(\n          { code: \"request_failed\", error: \"The survey assistant task request is too large.\" },\n          { status: 413 },\n        );\n      }\n      const task = surveyAssistantTaskRequestSchema.parse(JSON.parse(text));\n\n      const requestContext = new RequestContext<SurveyAssistantRequestContext>();\n      if (resolveModel) {\n        const modelSelection = await resolveModel({\n          identity,\n          request,\n          requestedModelId: task.modelId,\n        });\n        if (!modelSelection) {\n          return Response.json(\n            {\n              code: \"request_failed\",\n              error: \"The selected survey assistant model is unavailable.\",\n            },\n            { status: 400 },\n          );\n        }\n        requestContext.set(\"modelSelection\", modelSelection);\n      }\n\n      const resolvedAgent = typeof agent === \"function\" ? await agent() : agent;\n      const runtime: RunSurveyAssistantBuiltInTaskOptions = {\n        agent: resolvedAgent,\n        context: task.context,\n        mode: task.mode,\n        requestContext,\n        providerOptions,\n      };\n      const result =\n        task.taskId === \"suggest-item-key\"\n          ? await runSurveyAssistantSuggestItemKeyTask(task.input, runtime)\n          : task.taskId === \"suggest-item-label\"\n            ? await runSurveyAssistantSuggestItemLabelTask(task.input, runtime)\n            : await runSurveyAssistantTranslateContentTask(task.input, runtime);\n      return Response.json(result);\n    } catch (error) {\n      return taskErrorResponse(error);\n    }\n  };\n"],"mappings":"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"}
+{"version":3,"file":"server-tasks.mjs","names":[],"sources":["../src/server/tasks.ts"],"sourcesContent":["import { Agent, type AgentConfig, type AgentExecutionOptions } from \"@mastra/core/agent\";\nimport { RequestContext } from \"@mastra/core/request-context\";\nimport { z } from \"zod\";\nimport { surveyAssistantTaskRequestSchema } from \"../protocol\";\nimport type {\n  SurveyAssistantSuggestItemKeyInput,\n  SurveyAssistantSuggestItemKeyResult,\n  SurveyAssistantKeySuggestionCategory,\n  SurveyAssistantSuggestItemLabelInput,\n  SurveyAssistantSuggestItemLabelResult,\n  SurveyAssistantTaskInvocationMode,\n  SurveyAssistantTaskContext,\n  SurveyAssistantTranslateContentInput,\n  SurveyAssistantTranslateContentResult,\n} from \"../protocol\";\nimport {\n  surveyAuthoringReferences,\n  type SurveyAuthoringReferenceTopic,\n} from \"./authoring-references\";\nimport type {\n  SurveyAssistantModelSelection,\n  SurveyAssistantRequestContext,\n} from \"./request-context\";\nimport { SURVEY_ASSISTANT_TASK_AGENT_ID } from \"./constants\";\nimport { readSurveyAssistantRequestJson, SurveyAssistantRequestError } from \"./request-guardrails\";\n\ntype SurveyAssistantTaskAgentConfig = AgentConfig<\n  typeof SURVEY_ASSISTANT_TASK_AGENT_ID,\n  Record<string, never>,\n  undefined,\n  SurveyAssistantRequestContext\n>;\n\nexport interface CreateSurveyAssistantTaskAgentOptions {\n  model: SurveyAssistantTaskAgentConfig[\"model\"];\n}\n\nexport const createSurveyAssistantTaskAgent = ({ model }: CreateSurveyAssistantTaskAgentOptions) =>\n  new Agent<\n    typeof SURVEY_ASSISTANT_TASK_AGENT_ID,\n    Record<string, never>,\n    undefined,\n    SurveyAssistantRequestContext\n  >({\n    id: SURVEY_ASSISTANT_TASK_AGENT_ID,\n    name: \"Survey Assistant Tasks\",\n    instructions:\n      \"Perform the supplied bounded survey-authoring task and return only its requested structured output.\",\n    model,\n  });\n\nexport interface RunSurveyAssistantTaskOptions<TSchema extends z.ZodType> {\n  agent: Pick<Agent, \"generate\">;\n  taskId: string;\n  input: unknown;\n  context: SurveyAssistantTaskContext;\n  schema: TSchema;\n  instructions: readonly string[];\n  referenceTopics?: readonly SurveyAuthoringReferenceTopic[];\n  requestContext?: RequestContext<SurveyAssistantRequestContext>;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  abortSignal?: AbortSignal;\n}\n\nconst BASE_TASK_INSTRUCTIONS = [\n  \"You perform one bounded CASE Survey Editor AI task and return only the requested structured result.\",\n  \"The supplied task context was derived from the current canonical survey document snapshot. Use it as current survey context, but do not mutate it and do not claim that any editor change was applied.\",\n  \"Follow the supplied CASE authoring references where relevant. Do not invent item types, locales, ids, or capabilities that are absent from the task input and context.\",\n  \"Keep generated respondent-facing wording neutral, concise, and consistent with the requested locale and surrounding survey content.\",\n] as const;\n\nexport const runSurveyAssistantTask = async <TSchema extends z.ZodType>({\n  agent,\n  taskId,\n  input,\n  context,\n  schema,\n  instructions,\n  referenceTopics = [],\n  requestContext,\n  providerOptions,\n  abortSignal,\n}: RunSurveyAssistantTaskOptions<TSchema>): Promise<z.output<TSchema>> => {\n  const references = referenceTopics.map((topic) => ({\n    topic,\n    title: surveyAuthoringReferences[topic].title,\n    content: surveyAuthoringReferences[topic].content,\n  }));\n  const response = await agent.generate(\n    JSON.stringify({ taskId, input, currentSurveyContext: context }),\n    {\n      instructions: [\n        ...BASE_TASK_INSTRUCTIONS,\n        ...instructions,\n        ...references.map((entry) => `Reference: ${entry.title}\\n${entry.content}`),\n      ],\n      activeTools: [],\n      inputProcessors: [],\n      maxSteps: 1,\n      structuredOutput: {\n        schema,\n        errorStrategy: \"strict\",\n      },\n      ...(requestContext ? { requestContext } : {}),\n      ...(providerOptions ? { providerOptions } : {}),\n      ...(abortSignal ? { abortSignal } : {}),\n    },\n  );\n\n  return schema.parse(response.object);\n};\n\nconst keySuggestionValueSchema = z.object({\n  text: z.string().min(1),\n  rationale: z.string().optional(),\n});\n\nconst keySuggestionCategorySchema = z.enum([\"survey-pattern\", \"compact\", \"preferred\", \"fair\"]);\n\nconst keySuggestionSchema = z.object({\n  surveyPattern: keySuggestionValueSchema.describe(\n    \"A key that follows the strongest naming and numbering pattern in the current survey.\",\n  ),\n  compact: keySuggestionValueSchema.extend({\n    text: z\n      .string()\n      .min(2)\n      .max(5)\n      .regex(/^[A-Z][A-Z0-9]{1,4}$/)\n      .describe(\"A recognizable 2-5 character uppercase abbreviation.\"),\n  }),\n  preferred: keySuggestionValueSchema.describe(\n    \"The key the model considers clearest without a category-specific naming constraint.\",\n  ),\n  fair: keySuggestionValueSchema.extend({\n    text: z\n      .string()\n      .min(1)\n      .max(32)\n      .regex(/^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/)\n      .describe(\"A FAIR-by-design lowercase snake_case variable name.\"),\n  }),\n  alternatives: z\n    .array(\n      keySuggestionValueSchema.extend({\n        category: keySuggestionCategorySchema,\n      }),\n    )\n    .max(2),\n});\n\nconst labelSuggestionSchema = z.object({\n  suggestions: z.array(\n    z.object({\n      text: z.string().min(1),\n    }),\n  ),\n});\n\nconst translationsSchema = z.object({\n  translations: z.record(z.string(), z.record(z.string(), z.string())),\n});\n\nexport interface RunSurveyAssistantBuiltInTaskOptions {\n  agent: Pick<Agent, \"generate\">;\n  context: SurveyAssistantTaskContext;\n  mode?: SurveyAssistantTaskInvocationMode;\n  requestContext?: RequestContext<SurveyAssistantRequestContext>;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  abortSignal?: AbortSignal;\n}\n\nconst clampLimit = (value: number | undefined, fallback: number, maximum: number) =>\n  Math.min(Math.max(1, value ?? fallback), maximum);\n\nconst sanitizeCodingKey = (value: string) =>\n  value\n    .trim()\n    .replace(/[.\\s-]+/g, \"_\")\n    .replace(/[^A-Za-z0-9_]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\nconst getCodingKeyIdentity = (value: string) => sanitizeCodingKey(value).toLocaleLowerCase();\n\nconst getNumberedKeyParts = (value: string) => {\n  const match = /^(.+?)_(\\d+)$/.exec(getCodingKeyIdentity(value));\n  return match ? { stem: match[1], number: Number(match[2]) } : undefined;\n};\n\nconst isUnsupportedFocusedItemSequence = (\n  candidate: string,\n  input: SurveyAssistantSuggestItemKeyInput,\n  context: SurveyAssistantTaskContext,\n) => {\n  const candidateParts = getNumberedKeyParts(candidate);\n  const focusItem = context.focus?.item;\n  if (!candidateParts || !focusItem) return false;\n\n  const focusedKeyParts = [input.currentKey, input.draftKey, focusItem.key]\n    .map(getNumberedKeyParts)\n    .find((parts) => parts?.stem === candidateParts.stem && parts.number < candidateParts.number);\n  if (!focusedKeyParts) return false;\n\n  return !context.naming?.keyExamples.some((example) => {\n    const exampleParts = getNumberedKeyParts(example.key);\n    return example.itemType === focusItem.itemType && exampleParts?.stem === candidateParts.stem;\n  });\n};\n\nconst invocationInstruction = (mode: SurveyAssistantTaskInvocationMode | undefined) =>\n  mode === \"background\"\n    ? \"This is a background invocation. Be efficient, but do not relax task conventions, completeness, or output quality.\"\n    : \"This is an explicit user invocation. Prioritize quality and useful variation.\";\n\nexport const runSurveyAssistantSuggestItemKeyTask = async (\n  input: SurveyAssistantSuggestItemKeyInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantSuggestItemKeyResult> => {\n  const maxSuggestions = Math.min(Math.max(4, input.maxSuggestions ?? 6), 6);\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"suggest-item-key\",\n    input,\n    schema: keySuggestionSchema,\n    instructions: [\n      \"Generate coding keys for the focused survey item, not editor labels or respondent-facing text.\",\n      \"Infer the dominant topic from the focused item's visible text, descendants, hierarchy, and draft key.\",\n      \"For a group or other container, treat its own descendants as the primary evidence for what the container represents. Derive a descriptive group key from those children before considering generic default container names.\",\n      \"The input currentKey and draftKey, plus the focused item's key and fullKey in currentSurveyContext, identify the value being replaced. They may provide topic hints, but they are not evidence of an established naming or numbering pattern.\",\n      \"Use only currentSurveyContext.naming.keyExamples and sibling keys from other items to infer the survey's established naming pattern. Pay particular attention to prefixes, casing, separators, numeric sequences, and zero padding.\",\n      \"Treat a numeric pattern as established only when at least one other survey item supports it. For example, another item Q1_APPLES can support a topic-appropriate Q2_... key, while Q1_APPLES and Q2_ORANGES support Q3_.... The focused item's current key choice_1 by itself does not support choice_2 or a numeric suffix in other suggestions.\",\n      \"In particular, a focused group named group_1 is a default placeholder, not a group-numbering pattern. Do not propose group_2 (or another group_N key) from it unless another group/container in currentSurveyContext.naming.keyExamples independently uses the same group_N pattern. The group's children provide semantic context, not evidence of a group-numbering pattern.\",\n      \"Return one surveyPattern key that follows the strongest detected local pattern. Preserve that pattern's casing and increment a clear sequence rather than copying an existing number. If no meaningful pattern exists, use a consistent descriptive key.\",\n      \"Return one compact key: a recognizable 2-5 character uppercase abbreviation using only A-Z and digits.\",\n      \"Return one preferred key: the key you consider clearest and most useful without category-specific naming constraints, while still using only letters, digits, and underscores.\",\n      \"Return one fair key following these FAIR-by-design rules: start with a letter; use lowercase ASCII letters, digits, and underscores only; use lowercase snake_case; stay at or below 32 characters; avoid programming/database reserved words; prefer a stable, language-neutral English concept name; use established instrument prefixes and sortable item numbers when applicable; distinguish raw from derived variables. Meaning belongs in metadata, so do not turn it into a sentence.\",\n      `You may return up to ${Math.max(0, maxSuggestions - 4)} genuinely useful alternatives when another category has more than one strong candidate. Tag each alternative with its category.`,\n      \"Never repeat the same suggestion, including case-only or punctuation-only variations.\",\n      \"Do not return the current key, a sibling key, or a semantically unrelated abbreviation.\",\n      `Return between 4 and ${maxSuggestions} distinct suggestions in total.`,\n      invocationInstruction(options.mode),\n    ],\n  });\n\n  const excluded = new Set(\n    [input.currentKey, ...input.siblingKeys].map(getCodingKeyIdentity).filter(Boolean),\n  );\n  const seen = new Set<string>();\n  const categorizedSuggestions: Array<{\n    text: string;\n    rationale?: string;\n    category: SurveyAssistantKeySuggestionCategory;\n  }> = [\n    { ...result.surveyPattern, category: \"survey-pattern\" },\n    { ...result.compact, category: \"compact\" },\n    { ...result.preferred, category: \"preferred\" },\n    { ...result.fair, category: \"fair\" },\n    ...result.alternatives,\n  ];\n  const suggestions = categorizedSuggestions\n    .flatMap((suggestion) => {\n      const text = sanitizeCodingKey(suggestion.text);\n      const identity = getCodingKeyIdentity(text);\n      if (\n        !text ||\n        excluded.has(identity) ||\n        seen.has(identity) ||\n        isUnsupportedFocusedItemSequence(text, input, options.context)\n      ) {\n        return [];\n      }\n      seen.add(identity);\n      return [{ ...suggestion, text }];\n    })\n    .slice(0, maxSuggestions);\n  return { suggestions };\n};\n\nexport const runSurveyAssistantSuggestItemLabelTask = async (\n  input: SurveyAssistantSuggestItemLabelInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantSuggestItemLabelResult> => {\n  const maxSuggestions = clampLimit(input.maxSuggestions, 3, 10);\n  const locale = input.locale ?? options.context.survey.selectedLocale;\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"suggest-item-label\",\n    input,\n    schema: labelSuggestionSchema,\n    instructions: [\n      \"Suggest concise editor-only item labels, not coding keys and not respondent-facing question text.\",\n      \"Infer the item's purpose from its type, draft label, visible content, hierarchy, siblings, and descendants.\",\n      \"Use currentSurveyContext.naming.labelExamples to infer established capitalization, prefixes, abbreviations, delimiters, and typical length.\",\n      \"If existing label examples are available, the first suggestion must follow their dominant pattern while still describing the focused item accurately. Other suggestions may offer useful concise alternatives.\",\n      \"Do not copy the subject matter of an unrelated example merely to imitate its style, and do not return an existing unrelated label verbatim.\",\n      `Write labels in locale ${locale}.`,\n      `Return at most ${maxSuggestions} distinct, specific, human-readable suggestions.`,\n      invocationInstruction(options.mode),\n    ],\n    referenceTopics: [\"core-rules\"],\n  });\n\n  const normalizeLabel = (value: string) => value.trim().toLocaleLowerCase();\n  const excludedLabels = new Set([\n    normalizeLabel(input.draftLabel),\n    ...(options.context.naming?.labelExamples ?? []).map((example) =>\n      normalizeLabel(example.label),\n    ),\n  ]);\n  const seen = new Set<string>();\n  return {\n    suggestions: result.suggestions\n      .flatMap((suggestion) => {\n        const text = suggestion.text.trim();\n        const normalizedText = normalizeLabel(text);\n        if (!text || excludedLabels.has(normalizedText) || seen.has(normalizedText)) return [];\n        seen.add(normalizedText);\n        return [{ ...suggestion, text }];\n      })\n      .slice(0, maxSuggestions),\n  };\n};\n\nconst getProtectedTokens = (value: string) =>\n  value.match(/\\{\\{[^{}]+\\}\\}|\\{[^{}]+\\}|\\$\\{[^{}]+\\}|%\\d*\\$?[a-z]/gi) ?? [];\n\nexport const runSurveyAssistantTranslateContentTask = async (\n  input: SurveyAssistantTranslateContentInput,\n  options: RunSurveyAssistantBuiltInTaskOptions,\n): Promise<SurveyAssistantTranslateContentResult> => {\n  const result = await runSurveyAssistantTask({\n    ...options,\n    taskId: \"translate-content\",\n    input,\n    schema: translationsSchema,\n    instructions: [\n      \"Translate every supplied survey-content entry faithfully without adding explanations or omitting content.\",\n      `Translate from ${input.sourceLocale} into exactly these target locales: ${input.targetLocales.join(\", \")}.`,\n      \"Use currentSurveyContext.translation.examples as a terminology and style reference when relevant. The supplied source entries remain authoritative.\",\n      \"Preserve meaning, register, survey terminology, punctuation, line breaks, response semantics, placeholders, interpolation tokens, URLs, and identifiers that should not be translated.\",\n      \"Keep repeated terminology consistent across all entries and target locales. Do not use a neighboring translation when its meaning differs.\",\n      \"Return plain strings keyed first by target locale and then by the original entry id. Return every requested locale and entry exactly once.\",\n      invocationInstruction(options.mode),\n    ],\n    referenceTopics: [\"localization\"],\n  });\n\n  const translations: SurveyAssistantTranslateContentResult[\"translations\"] = {};\n  for (const locale of input.targetLocales) {\n    const entries = result.translations[locale];\n    if (!entries) throw new Error(`Translation result is missing locale ${locale}.`);\n    const translatedEntries: Record<string, string> = {};\n    for (const entry of input.entries) {\n      const translation = entries[entry.id];\n      if (typeof translation !== \"string\" || translation.trim().length === 0) {\n        throw new Error(`Translation result is missing entry ${entry.id} for locale ${locale}.`);\n      }\n      const sourceTokens = getProtectedTokens(entry.text).sort();\n      const translatedTokens = getProtectedTokens(translation).sort();\n      if (sourceTokens.join(\"\\u0000\") !== translatedTokens.join(\"\\u0000\")) {\n        throw new Error(\n          `Translation result changed protected tokens in entry ${entry.id} for locale ${locale}.`,\n        );\n      }\n      translatedEntries[entry.id] = translation;\n    }\n    translations[locale] = translatedEntries;\n  }\n  return { translations };\n};\n\nconst MAX_TASK_REQUEST_BYTES = 512 * 1024;\nconst DEFAULT_MAX_TASK_CONCURRENT_REQUESTS = 4;\nconst DEFAULT_MAX_TASK_DURATION_MS = 60_000;\n\nexport interface SurveyAssistantTaskAuthorizedIdentity {\n  resourceId: string;\n  surveyId?: string;\n}\n\nexport interface SurveyAssistantTaskAuthorizationInput {\n  request: Request;\n  requestedResourceId?: string;\n  requestedSurveyId?: string;\n}\n\nexport interface SurveyAssistantTaskModelResolutionInput {\n  identity: SurveyAssistantTaskAuthorizedIdentity;\n  request: Request;\n  requestedModelId?: string;\n}\n\nexport interface CreateSurveyAssistantTaskHandlerOptions {\n  agent:\n    | Pick<Agent, \"generate\">\n    | (() => Pick<Agent, \"generate\"> | Promise<Pick<Agent, \"generate\">>);\n  authorize(\n    input: SurveyAssistantTaskAuthorizationInput,\n  ): SurveyAssistantTaskAuthorizedIdentity | Promise<SurveyAssistantTaskAuthorizedIdentity>;\n  getReadinessError?(request: Request): string | null | Promise<string | null>;\n  isEnabled?(request: Request): boolean | Promise<boolean>;\n  maxConcurrentRequests?: number;\n  maxDurationMs?: number;\n  onTaskMetrics?(input: {\n    durationMs: number;\n    identity: SurveyAssistantTaskAuthorizedIdentity;\n    status: \"completed\" | \"failed\";\n    taskId: string;\n  }): void;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\n  resolveModel?(\n    input: SurveyAssistantTaskModelResolutionInput,\n  ):\n    | SurveyAssistantModelSelection\n    | null\n    | undefined\n    | Promise<SurveyAssistantModelSelection | null | undefined>;\n}\n\nconst taskErrorResponse = (error: unknown) => {\n  const status =\n    typeof error === \"object\" &&\n    error !== null &&\n    \"status\" in error &&\n    typeof error.status === \"number\"\n      ? error.status\n      : error instanceof SyntaxError || (error instanceof Error && error.name === \"ZodError\")\n        ? 400\n        : 500;\n  const message =\n    error instanceof SurveyAssistantRequestError\n      ? error.message\n      : status === 401 || status === 403 || status === 404\n        ? status === 404\n          ? \"Survey assistant task not found.\"\n          : \"The survey assistant task is not authorized.\"\n        : status >= 500\n          ? \"The survey assistant task could not be completed.\"\n          : \"The survey assistant task request is invalid.\";\n  return Response.json(\n    {\n      code:\n        status === 401 || status === 403 || status === 404\n          ? \"authorization_failed\"\n          : \"request_failed\",\n      error: message,\n    },\n    { status },\n  );\n};\n\nexport const createSurveyAssistantTaskHandler = ({\n  agent,\n  authorize,\n  getReadinessError,\n  isEnabled,\n  maxConcurrentRequests = DEFAULT_MAX_TASK_CONCURRENT_REQUESTS,\n  maxDurationMs = DEFAULT_MAX_TASK_DURATION_MS,\n  onTaskMetrics,\n  providerOptions,\n  resolveModel,\n}: CreateSurveyAssistantTaskHandlerOptions) => {\n  const concurrency =\n    Number.isInteger(maxConcurrentRequests) && maxConcurrentRequests > 0\n      ? maxConcurrentRequests\n      : DEFAULT_MAX_TASK_CONCURRENT_REQUESTS;\n  const duration =\n    Number.isFinite(maxDurationMs) && maxDurationMs > 0\n      ? maxDurationMs\n      : DEFAULT_MAX_TASK_DURATION_MS;\n  let activeRequests = 0;\n\n  return async (request: Request): Promise<Response> => {\n    if (activeRequests >= concurrency) {\n      return Response.json(\n        {\n          code: \"rate_limited\",\n          error: \"The survey assistant is handling too many tasks. Try again shortly.\",\n        },\n        { status: 429 },\n      );\n    }\n    activeRequests += 1;\n    const startedAt = Date.now();\n    let metricsIdentity: SurveyAssistantTaskAuthorizedIdentity | undefined;\n    let metricsTaskId = \"unknown\";\n    let completed = false;\n    try {\n      if (isEnabled && !(await isEnabled(request))) {\n        return Response.json(\n          { code: \"request_failed\", error: \"Survey assistant is disabled.\" },\n          { status: 404 },\n        );\n      }\n      const task = surveyAssistantTaskRequestSchema.parse(\n        await readSurveyAssistantRequestJson(request, MAX_TASK_REQUEST_BYTES),\n      );\n      metricsTaskId = task.taskId;\n      const identity = await authorize({\n        request,\n        requestedResourceId: task.resourceId,\n        requestedSurveyId: task.surveyId,\n      });\n      if (\n        !identity?.resourceId?.trim() ||\n        identity.resourceId.trim().length > 240 ||\n        (identity.surveyId !== undefined &&\n          (!identity.surveyId.trim() || identity.surveyId.trim().length > 240))\n      ) {\n        throw Object.assign(new Error(\"The host returned an invalid task identity.\"), {\n          status: 500,\n        });\n      }\n      metricsIdentity = {\n        resourceId: identity.resourceId.trim(),\n        ...(identity.surveyId?.trim() ? { surveyId: identity.surveyId.trim() } : {}),\n      };\n\n      const readinessError = await getReadinessError?.(request);\n      if (readinessError) {\n        return Response.json({ code: \"request_failed\", error: readinessError }, { status: 503 });\n      }\n\n      const requestContext = new RequestContext<SurveyAssistantRequestContext>();\n      if (resolveModel) {\n        const modelSelection = await resolveModel({\n          identity: metricsIdentity,\n          request,\n          requestedModelId: task.modelId,\n        });\n        if (!modelSelection) {\n          return Response.json(\n            {\n              code: \"request_failed\",\n              error: \"The selected survey assistant model is unavailable.\",\n            },\n            { status: 400 },\n          );\n        }\n        requestContext.set(\"modelSelection\", modelSelection);\n      }\n\n      const resolvedAgent = typeof agent === \"function\" ? await agent() : agent;\n      const runtime: RunSurveyAssistantBuiltInTaskOptions = {\n        abortSignal: AbortSignal.any([request.signal, AbortSignal.timeout(duration)]),\n        agent: resolvedAgent,\n        context: task.context,\n        mode: task.mode,\n        requestContext,\n        providerOptions,\n      };\n      const result =\n        task.taskId === \"suggest-item-key\"\n          ? await runSurveyAssistantSuggestItemKeyTask(task.input, runtime)\n          : task.taskId === \"suggest-item-label\"\n            ? await runSurveyAssistantSuggestItemLabelTask(task.input, runtime)\n            : await runSurveyAssistantTranslateContentTask(task.input, runtime);\n      completed = true;\n      return Response.json(result);\n    } catch (error) {\n      return taskErrorResponse(error);\n    } finally {\n      activeRequests = Math.max(0, activeRequests - 1);\n      if (metricsIdentity) {\n        try {\n          onTaskMetrics?.({\n            durationMs: Date.now() - startedAt,\n            identity: metricsIdentity,\n            status: completed ? \"completed\" : \"failed\",\n            taskId: metricsTaskId,\n          });\n        } catch {\n          // Host metrics must not change the task response.\n        }\n      }\n    }\n  };\n};\n"],"mappings":"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"}

package/dist/server-tools.d.mts

@@ -1,2 +1,2 @@
-import { i as surveyAuditTool, n as surveyAssistantTools, r as surveyAssetTool, t as SURVEY_ASSISTANT_TOOL_IDS } from "./index-MpEMQzTm.mjs";
+import { i as surveyAuditTool, n as surveyAssistantTools, r as surveyAssetTool, t as SURVEY_ASSISTANT_TOOL_IDS } from "./index-B_x2IYi7.mjs";
 export { SURVEY_ASSISTANT_TOOL_IDS, surveyAssetTool, surveyAssistantTools, surveyAuditTool };

package/dist/server-tools.mjs

@@ -1,2 +1,2 @@
-import { i as surveyAuditTool, n as surveyAssistantTools, r as surveyAssetTool, t as SURVEY_ASSISTANT_TOOL_IDS } from "./tools-Hz2p7vyv.mjs";
+import { i as surveyAuditTool, n as surveyAssistantTools, r as surveyAssetTool, t as SURVEY_ASSISTANT_TOOL_IDS } from "./tools-DDXaJ8Za.mjs";
 export { SURVEY_ASSISTANT_TOOL_IDS, surveyAssetTool, surveyAssistantTools, surveyAuditTool };

package/dist/server.d.mts

@@ -1,36 +1,104 @@
-import { g as TurnChangeCollector } from "./index-CUqbBjkc.mjs";
-import { a as SurveyAssistantThreadDocumentRepository, c as loadSurveyAssistantThreadAttachments, i as SurveyAssistantThreadDocumentContent, l as registerSurveyAssistantThreadAttachments, n as SurveyAssistantModelAttachment, o as getSurveyAssistantReplayableDocuments, r as SurveyAssistantThreadDocument, s as loadSurveyAssistantDocuments, t as SurveyAssistantAttachmentAccess, u as removeHistoricalSurveyAssistantAttachments } from "./thread-documents-DamIq9Od.mjs";
-import { a as SurveyAssistantRequestContext, c as parseSurveyAssistantSnapshot, i as SurveyAssistantModelSelection, l as requireSurveyAssistantTurnState, n as SURVEY_ASSISTANT_TASK_AGENT_ID, o as SurveyAssistantSnapshotSource, r as SurveyAssistantIdentityContext, s as buildSurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID } from "./constants-Jw0k8ojS.mjs";
-import { _ as formatSurveyAssistantStreamError, a as createSurveyAssistantThreadHandlers, c as SurveyAssistantAuthorize, d as SurveyAssistantModelResolutionInput, f as SurveyAssistantResolveModel, g as describeSurveyAssistantStreamError, h as createSurveyAssistantChatHandler, i as SurveyAssistantThreadRepository, l as SurveyAssistantAuthorizedIdentity, m as SurveyAssistantTurnMetrics, n as SurveyAssistantStoredThread, o as SurveyAssistantAuthorizationError, p as SurveyAssistantStreamErrorContext, r as SurveyAssistantThreadIdentity, s as SurveyAssistantAuthorizationInput, t as CreateSurveyAssistantThreadHandlersOptions, u as SurveyAssistantChatHandlerOptions } from "./thread-handlers-DpynUc64.mjs";
-import { n as surveyAuthoringReferenceTopics, r as surveyAuthoringReferences, t as SurveyAuthoringReferenceTopic } from "./authoring-references-Cy8J-DWt.mjs";
-import { UIMessage, UIMessageChunk } from "ai";
+import { g as TurnChangeCollector } from "./index-DZ6KBwVR.mjs";
+import { a as SurveyAssistantThreadDocumentRepository, c as loadSurveyAssistantThreadAttachments, d as replaceCurrentSurveyAssistantAttachmentsWithReferences, i as SurveyAssistantThreadDocumentContent, l as registerSurveyAssistantThreadAttachments, n as SurveyAssistantModelAttachment, o as getSurveyAssistantReplayableDocuments, r as SurveyAssistantThreadDocument, s as loadSurveyAssistantDocuments, t as SurveyAssistantAttachmentAccess, u as removeHistoricalSurveyAssistantAttachments } from "./thread-documents-BlxNjc7S.mjs";
+import { a as SurveyAssistantModelSelection, c as deriveSurveyAssistantDocumentTransition, d as requireSurveyAssistantTurnState, i as SurveyAssistantIdentityContext, l as parseSurveyAssistantPreviousSettledVersion, n as SURVEY_ASSISTANT_TASK_AGENT_ID, o as SurveyAssistantRequestContext, r as SurveyAssistantDocumentTransition, s as buildSurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID, u as parseSurveyAssistantSnapshot } from "./constants-56jf_4ls.mjs";
+import { A as validateSurveyAssistantMessages, C as SURVEY_ASSISTANT_MAX_MESSAGES, D as SurveyAssistantRequestError, E as SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES, O as SurveyAssistantRequestLimits, S as SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS, T as SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS, _ as formatSurveyAssistantStreamError, a as createSurveyAssistantThreadHandlers, b as SURVEY_ASSISTANT_MAX_ATTACHMENTS, c as SurveyAssistantAuthorize, d as SurveyAssistantModelResolutionInput, f as SurveyAssistantResolveModel, g as describeSurveyAssistantStreamError, h as createSurveyAssistantChatHandler, i as SurveyAssistantThreadRepository, k as readSurveyAssistantRequestJson, l as SurveyAssistantAuthorizedIdentity, m as SurveyAssistantTurnMetrics, n as SurveyAssistantStoredThread, o as SurveyAssistantAuthorizationError, p as SurveyAssistantStreamErrorContext, r as SurveyAssistantThreadIdentity, s as SurveyAssistantAuthorizationInput, t as CreateSurveyAssistantThreadHandlersOptions, u as SurveyAssistantChatHandlerOptions, v as SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES, w as SURVEY_ASSISTANT_MAX_REQUEST_BYTES, x as SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES, y as SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS } from "./thread-handlers-l79JBl5m.mjs";
+import { a as SurveyAssistantTaskAuthorizationInput, g as surveyAuthoringReferences, h as surveyAuthoringReferenceTopics, m as SurveyAuthoringReferenceTopic, o as SurveyAssistantTaskAuthorizedIdentity } from "./tasks-COQnhSeT.mjs";
+import { UIMessageChunk } from "ai";
 import { MastraMemory } from "@mastra/core/memory";
 
 //#region src/server/memory-thread-repository.d.ts
 type ThreadMemory = Pick<MastraMemory, "createThread" | "deleteThread" | "getThreadById" | "listThreads" | "recall" | "updateThread">;
 interface CreateMastraMemoryThreadRepositoryOptions {
   getMemory(): ThreadMemory | Promise<ThreadMemory>;
+  /** Maximum recent messages returned when hydrating a transcript. */
+  maxMessagesPerTranscript?: number;
+  /** Maximum recent threads returned by the history endpoint. */
+  maxThreadsPerList?: number;
   threadDocuments?: SurveyAssistantThreadDocumentRepository;
 }
 declare const createMastraMemoryThreadRepository: ({
   getMemory,
+  maxMessagesPerTranscript,
+  maxThreadsPerList,
   threadDocuments
 }: CreateMastraMemoryThreadRepositoryOptions) => SurveyAssistantThreadRepository;
 //#endregion
-//#region src/server/request-guardrails.d.ts
-declare const SURVEY_ASSISTANT_MAX_REQUEST_BYTES: number;
-declare const SURVEY_ASSISTANT_MAX_MESSAGES = 32;
-declare const SURVEY_ASSISTANT_MAX_ATTACHMENTS = 4;
-declare const SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES: number;
-declare const SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES: number;
-declare const SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS = 64000;
-declare const SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES: Set<string>;
-declare class SurveyAssistantRequestError extends Error {
-  readonly status: number;
-  constructor(message: string, status?: number);
-}
-declare const validateSurveyAssistantMessages: (value: unknown) => UIMessage[];
-declare const readSurveyAssistantRequestJson: (request: Request) => Promise<unknown>;
+//#region src/server/survey-lifecycle.d.ts
+declare const SURVEY_ASSISTANT_SURVEY_ID_METADATA_KEY = "surveyId";
+type SurveyLifecycleMemory = Pick<MastraMemory, "deleteThread" | "getThreadById" | "listThreads" | "recall" | "createThread" | "updateThread">;
+interface CreateSurveyAssistantSurveyLifecycleOptions {
+  getMemory(): SurveyLifecycleMemory | Promise<SurveyLifecycleMemory>;
+  /** Optionally derives the survey-scoped thread endpoint exposed in `panelProps`. */
+  getThreadApi?(surveyId: string): string;
+  /**
+   * Stable host metadata that separates this assistant deployment from any
+   * other application using the same Mastra storage.
+   */
+  scopeMetadata: Record<string, string>;
+  /**
+   * Pass the same repository used by the chat handler, or explicitly use
+   * `false` when cross-turn attachment persistence/replay is disabled.
+   */
+  threadDocuments: SurveyAssistantThreadDocumentRepository | false;
+}
+interface DeleteSurveyAssistantSurveyThreadsInput {
+  surveyId: string;
+  /** Restrict cleanup to one user. Omit this when the survey itself is deleted. */
+  resourceId?: string;
+}
+interface SurveyAssistantThreadCleanupResult {
+  deletedThreadIds: string[];
+  matchedThreadCount: number;
+}
+type DeleteSurveyAssistantSurveyThreadsResult = SurveyAssistantThreadCleanupResult;
+interface SurveyAssistantSurveyPanelProps {
+  resourceId: string;
+  surveyId: string;
+  threadApi?: string;
+}
+interface SurveyAssistantScopedSurvey {
+  /** Validates the requested ids and returns a trusted identity for the chat handler. */
+  authorizeChat: SurveyAssistantAuthorize;
+  /** Validates the requested survey/resource ids for the bounded task handler. */
+  authorizeTask(input: SurveyAssistantTaskAuthorizationInput): SurveyAssistantTaskAuthorizedIdentity;
+  /** Deletes this user's threads for the survey. */
+  deleteThreads(): Promise<DeleteSurveyAssistantSurveyThreadsResult>;
+  /** Returns true only for a thread in this exact deployment, survey, and user scope. */
+  ownsThread(thread: SurveyAssistantStoredThread | null | undefined): thread is SurveyAssistantStoredThread;
+  /** Props that can be passed directly to ConnectedSurveyAssistantPanel. */
+  panelProps: SurveyAssistantSurveyPanelProps;
+  resourceId: string;
+  surveyId: string;
+  /** Identity returned by the thread handler's authorize callback. */
+  threadIdentity: SurveyAssistantThreadIdentity;
+}
+interface SurveyAssistantSurveyLifecycle {
+  /** Deletes this resource's threads across every survey in this deployment scope. */
+  deleteResource(resourceId: string): Promise<SurveyAssistantThreadCleanupResult>;
+  /** Deletes every user's threads for a survey. */
+  deleteSurvey(surveyId: string): Promise<SurveyAssistantThreadCleanupResult>;
+  deleteSurveyThreads(input: DeleteSurveyAssistantSurveyThreadsInput): Promise<SurveyAssistantThreadCleanupResult>;
+  forSurvey(surveyId: string, resourceId: string): SurveyAssistantScopedSurvey;
+}
+declare const createSurveyAssistantSurveyThreadMetadata: ({
+  scopeMetadata,
+  surveyId
+}: {
+  scopeMetadata: Record<string, string>;
+  surveyId: string;
+}) => Record<string, string>;
+/**
+ * Creates an idempotent, server-only lifecycle service for removing every
+ * assistant thread owned by a survey. Hosts should call this after preventing
+ * new assistant activity and before completing (or from a durable retry of)
+ * survey deletion.
+ */
+declare const createSurveyAssistantSurveyLifecycle: ({
+  getMemory,
+  getThreadApi,
+  scopeMetadata,
+  threadDocuments
+}: CreateSurveyAssistantSurveyLifecycleOptions) => SurveyAssistantSurveyLifecycle;
 //#endregion
 //#region src/server/turn-stream.d.ts
 interface SurveyAssistantTurnStreamOptions {
@@ -48,5 +116,5 @@ declare const createSurveyAssistantTurnStream: ({
   stream
 }: SurveyAssistantTurnStreamOptions) => ReadableStream<UIMessageChunk>;
 //#endregion
-export { type CreateMastraMemoryThreadRepositoryOptions, type CreateSurveyAssistantThreadHandlersOptions, SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES, SURVEY_ASSISTANT_AGENT_ID, SURVEY_ASSISTANT_MAX_ATTACHMENTS, SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES, SURVEY_ASSISTANT_MAX_MESSAGES, SURVEY_ASSISTANT_MAX_REQUEST_BYTES, SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS, SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES, SURVEY_ASSISTANT_TASK_AGENT_ID, type SurveyAssistantAttachmentAccess, SurveyAssistantAuthorizationError, type SurveyAssistantAuthorizationInput, type SurveyAssistantAuthorize, type SurveyAssistantAuthorizedIdentity, type SurveyAssistantChatHandlerOptions, type SurveyAssistantIdentityContext, type SurveyAssistantModelAttachment, type SurveyAssistantModelResolutionInput, type SurveyAssistantModelSelection, type SurveyAssistantRequestContext, SurveyAssistantRequestError, type SurveyAssistantResolveModel, type SurveyAssistantSnapshotSource, type SurveyAssistantStoredThread, type SurveyAssistantStreamErrorContext, type SurveyAssistantThreadDocument, type SurveyAssistantThreadDocumentContent, type SurveyAssistantThreadDocumentRepository, type SurveyAssistantThreadIdentity, type SurveyAssistantThreadRepository, type SurveyAssistantTurnMetrics, type SurveyAssistantTurnStreamOptions, type SurveyAuthoringReferenceTopic, buildSurveyAssistantRequestContext, createMastraMemoryThreadRepository, createSurveyAssistantChatHandler, createSurveyAssistantThreadHandlers, createSurveyAssistantTurnStream, describeSurveyAssistantStreamError, formatSurveyAssistantStreamError, getSurveyAssistantReplayableDocuments, loadSurveyAssistantDocuments, loadSurveyAssistantThreadAttachments, parseSurveyAssistantSnapshot, readSurveyAssistantRequestJson, registerSurveyAssistantThreadAttachments, removeHistoricalSurveyAssistantAttachments, requireSurveyAssistantTurnState, surveyAuthoringReferenceTopics, surveyAuthoringReferences, validateSurveyAssistantMessages };
+export { type CreateMastraMemoryThreadRepositoryOptions, type CreateSurveyAssistantSurveyLifecycleOptions, type CreateSurveyAssistantThreadHandlersOptions, type DeleteSurveyAssistantSurveyThreadsInput, type DeleteSurveyAssistantSurveyThreadsResult, SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES, SURVEY_ASSISTANT_AGENT_ID, SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS, SURVEY_ASSISTANT_MAX_ATTACHMENTS, SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES, SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS, SURVEY_ASSISTANT_MAX_MESSAGES, SURVEY_ASSISTANT_MAX_REQUEST_BYTES, SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS, SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES, SURVEY_ASSISTANT_SURVEY_ID_METADATA_KEY, SURVEY_ASSISTANT_TASK_AGENT_ID, type SurveyAssistantAttachmentAccess, SurveyAssistantAuthorizationError, type SurveyAssistantAuthorizationInput, type SurveyAssistantAuthorize, type SurveyAssistantAuthorizedIdentity, type SurveyAssistantChatHandlerOptions, type SurveyAssistantDocumentTransition, type SurveyAssistantIdentityContext, type SurveyAssistantModelAttachment, type SurveyAssistantModelResolutionInput, type SurveyAssistantModelSelection, type SurveyAssistantRequestContext, SurveyAssistantRequestError, type SurveyAssistantRequestLimits, type SurveyAssistantResolveModel, type SurveyAssistantScopedSurvey, type SurveyAssistantStoredThread, type SurveyAssistantStreamErrorContext, type SurveyAssistantSurveyLifecycle, type SurveyAssistantSurveyPanelProps, type SurveyAssistantThreadCleanupResult, type SurveyAssistantThreadDocument, type SurveyAssistantThreadDocumentContent, type SurveyAssistantThreadDocumentRepository, type SurveyAssistantThreadIdentity, type SurveyAssistantThreadRepository, type SurveyAssistantTurnMetrics, type SurveyAssistantTurnStreamOptions, type SurveyAuthoringReferenceTopic, buildSurveyAssistantRequestContext, createMastraMemoryThreadRepository, createSurveyAssistantChatHandler, createSurveyAssistantSurveyLifecycle, createSurveyAssistantSurveyThreadMetadata, createSurveyAssistantThreadHandlers, createSurveyAssistantTurnStream, deriveSurveyAssistantDocumentTransition, describeSurveyAssistantStreamError, formatSurveyAssistantStreamError, getSurveyAssistantReplayableDocuments, loadSurveyAssistantDocuments, loadSurveyAssistantThreadAttachments, parseSurveyAssistantPreviousSettledVersion, parseSurveyAssistantSnapshot, readSurveyAssistantRequestJson, registerSurveyAssistantThreadAttachments, removeHistoricalSurveyAssistantAttachments, replaceCurrentSurveyAssistantAttachmentsWithReferences, requireSurveyAssistantTurnState, surveyAuthoringReferenceTopics, surveyAuthoringReferences, validateSurveyAssistantMessages };
 //# sourceMappingURL=server.d.mts.map

package/dist/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server/memory-thread-repository.ts","../src/server/request-guardrails.ts","../src/server/turn-stream.ts"],"mappings":";;;;;;;;;KAKK,YAAA,GAAe,IAAA,CAClB,YAAA;AAAA,UAIe,yCAAA;EACf,SAAA,IAAa,YAAA,GAAe,OAAA,CAAQ,YAAA;EACpC,eAAA,GAAkB,uCAAA;AAAA;AAAA,cAGP,kCAAA;EAAsC,SAAA;EAAA;AAAA,GAGhD,yCAAA,KAA4C,+BAAA;;;cChBlC,kCAAA;AAAA,cACA,6BAAA;AAAA,cACA,gCAAA;AAAA,cACA,qCAAA;AAAA,cACA,2CAAA;AAAA,cACA,oCAAA;AAAA,cAEA,0CAAA,EAA0C,GAAA;AAAA,cAQ1C,2BAAA,SAAoC,KAAA;EAAA,SACtC,MAAA;cAEG,OAAA,UAAiB,MAAA;AAAA;AAAA,cAqBlB,+BAAA,GAAmC,KAAA,cAAiB,SAAA;AAAA,cA2EpD,8BAAA,GAAwC,OAAA,EAAS,OAAA,KAAU,OAAA;;;UCvGvD,gCAAA;EACf,MAAA,EAAQ,cAAA,CAAe,cAAA;EACvB,eAAA,EAAiB,mBAAA;EACjB,MAAA,GAAS,WAAA;EACT,iBAAA,IAAqB,KAAA;EACrB,SAAA;AAAA;AAAA,cAGW,+BAAA;EAAmC,eAAA;EAAA,SAAA;EAAA,iBAAA;EAAA,MAAA;EAAA;AAAA,GAM7C,gCAAA,KAAmC,cAAA,CAAe,cAAA"}
+{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server/memory-thread-repository.ts","../src/server/survey-lifecycle.ts","../src/server/turn-stream.ts"],"mappings":";;;;;;;;;KAKK,YAAA,GAAe,IAAA,CAClB,YAAA;AAAA,UAIe,yCAAA;EACf,SAAA,IAAa,YAAA,GAAe,OAAA,CAAQ,YAAA;;EAEpC,wBAAA;;EAEA,iBAAA;EACA,eAAA,GAAkB,uCAAA;AAAA;AAAA,cAGP,kCAAA;EAAsC,SAAA;EAAA,wBAAA;EAAA,iBAAA;EAAA;AAAA,GAKhD,yCAAA,KAA4C,+BAAA;;;cCTlC,uCAAA;AAAA,KAER,qBAAA,GAAwB,IAAA,CAC3B,YAAA;AAAA,UAIe,2CAAA;EACf,SAAA,IAAa,qBAAA,GAAwB,OAAA,CAAQ,qBAAA;EDlB1C;ECoBH,YAAA,EAAc,QAAA;;;;ADfhB;ECoBE,aAAA,EAAe,MAAA;;;;;EAKf,eAAA,EAAiB,uCAAA;AAAA;AAAA,UAGF,uCAAA;EACf,QAAA;ED5Ba;EC8Bb,UAAA;AAAA;AAAA,UAGe,kCAAA;EACf,gBAAA;EACA,kBAAA;AAAA;AAAA,KAGU,wCAAA,GAA2C,kCAAA;AAAA,UAEtC,+BAAA;EACf,UAAA;EACA,QAAA;EACA,SAAA;AAAA;AAAA,UAGe,2BAAA;EDtCkC;ECwCjD,aAAA,EAAe,wBAAA;EDnCd;ECqCD,aAAA,CACE,KAAA,EAAO,qCAAA,GACN,qCAAA;EDAH;ECEA,aAAA,IAAiB,OAAA,CAAQ,wCAAA;ED9CwB;ECgDjD,UAAA,CACE,MAAA,EAAQ,2BAAA,sBACP,MAAA,IAAU,2BAAA;EDlDoC;ECoDjD,UAAA,EAAY,+BAAA;EACZ,UAAA;EACA,QAAA;EDtDiD;ECwDjD,cAAA,EAAgB,6BAAA;AAAA;AAAA,UAGD,8BAAA;EDff;ECiBA,cAAA,CAAe,UAAA,WAAqB,OAAA,CAAQ,kCAAA;;EAE5C,YAAA,CAAa,QAAA,WAAmB,OAAA,CAAQ,kCAAA;EACxC,mBAAA,CACE,KAAA,EAAO,uCAAA,GACN,OAAA,CAAQ,kCAAA;EACX,SAAA,CAAU,QAAA,UAAkB,UAAA,WAAqB,2BAAA;AAAA;AAAA,cAmCtC,yCAAA;EAA6C,aAAA;EAAA;AAAA;EAIxD,aAAA,EAAe,MAAA;EACf,QAAA;AAAA,MACE,MAAA;;;;;AAzGJ;;cAuHa,oCAAA;EAAwC,SAAA;EAAA,YAAA;EAAA,aAAA;EAAA;AAAA,GAKlD,2CAAA,KAA8C,8BAAA;;;UCrIhC,gCAAA;EACf,MAAA,EAAQ,cAAA,CAAe,cAAA;EACvB,eAAA,EAAiB,mBAAA;EACjB,MAAA,GAAS,WAAA;EACT,iBAAA,IAAqB,KAAA;EACrB,SAAA;AAAA;AAAA,cAGW,+BAAA;EAAmC,eAAA;EAAA,SAAA;EAAA,iBAAA;EAAA,MAAA;EAAA;AAAA,GAM7C,gCAAA,KAAmC,cAAA,CAAe,cAAA"}