@case-framework/survey-assistant 0.1.0 → 0.2.0

package/dist/references/item-types.md

@@ -21,13 +21,14 @@ Use a group when its children form a meaningful, independently managed section o
 ## Editor Presentation
 
 Every item has three distinct naming/presentation surfaces:
+
 - `key`: stable coding key used in expressions and response paths. Change it with `update-item-key`.
 - `metadata.itemLabel`: internal editor label, not shown to respondents. Change it with `update-item-label`.
 - `metadata.editorItemColor`: editor-only color swatch, not shown to respondents. Change it with `update-item-color`.
 
 Across editor views, an unqualified request for labels on one or more items/questions means `metadata.itemLabel`, including the visible \"Add label...\" editor control. It does not mean respondent-facing question titles, option labels, or form-field labels unless the user says so. Do not ask for clarification when the requested item set is clear; inspect/search to resolve that set when needed. Clarify only if the request explicitly spans multiple label surfaces.
 
-`update-item-color.color` must be one of the editor palette values: `#404040` (gray), `#b91c1c` (red), `#c2410c` (orange), `#a16207` (amber), `#4d7c0f` (green), `#047857` (teal), `#0369a1` (blue), `#4338ca` (indigo), `#7e22ce` (violet), `#86198f` (magenta), or `#be123c` (rose). Use it only when the user asks for editor organization or color; it must not be used to imply respondent-facing meaning.
+`update-item-color.color` must be one of the editor palette values provided in the `survey_change` tool contract. Use it only when the user asks for editor organization or color; it must not be used to imply respondent-facing meaning.
 
 ## page-break
 
@@ -50,14 +51,13 @@ Interactive choice question:
     "id": "<itemId>",
     "maxSelection": 1,
     "shuffleOptions": false,
-    "options": [
-      { "id": "fuji", "key": "FUJI" }
-    ]
+    "options": [{ "id": "fuji", "key": "FUJI" }]
   }
 }
 ```
 
 Choice conventions:
+
 - `maxSelection: 1` means single select.
 - `maxSelection: null` means multiple select with no cap.
 - `maxSelection: n` means multiple select capped at n selections.
@@ -71,10 +71,15 @@ Choice conventions:
 - Do not use provider-specific label metadata such as `labelKey`. CASE resolves every respondent-visible option label from `options.<optionId>.label` translations.
 - CASE choice options do not currently have a separate visible option-description field. If source material has an option-specific parenthetical/note, include it in the option label or move it to nearby question content. The `survey_change` normalizer preserves shorthand `option.note`, `option.description`, `option.helpText`, and `option.footnoteMarker` by folding them into the label translation.
 - If an option has an embedded form, do not duplicate trailing completion words in both the option label and field label. The normalizer strips trailing `, namelijk`, `, please specify`, `, specify`, `, explain`, and `, toelichting` from embedded-form option labels before validation.
-- The main response slot is `<itemId>...get...<config.id>`; normally `config.id` equals item id.
+- The main response slot is `<itemId>...get...<config.id>`. For a new choice item, always set
+  `config.id` to the exact same value as `item.id`; do not invent a second semantic name from the
+  question wording and do not add ordering suffixes such as `q1`. The choice response-slot ID has no
+  direct editor control and expressions refer to it exactly, so changing it later requires updating
+  every reference in the same change.
 - Single select returns `reference`; multiple select returns `reference[]`.
 
 Embedded option forms:
+
 - There is no `allowOther` flag in the current choice item model. Do not use `allowOther` to create free-text "Other" inputs.
 - CRITICAL — exact key name: the field on the option object is `embeddedForm` (singular, one object). It is NEVER `embeddedForms` (plural) and NEVER an array. The option's recognized keys are only: `id`, `key`, `label`, `hasDisplayCondition`, `embeddedFormItemId`, `embeddedForm`. Any other key (including a typo'd/pluralized `embeddedForms`) is silently dropped during validation — no error is raised, the field simply never appears, and you must not report the change as successful if you are not certain you used the exact singular key.
 - CRITICAL — exact shape: `embeddedForm` fields are never listed directly as `embeddedForm.fields`. They must be nested inside `embeddedForm.fieldGroups`, an array of groups, each with its own `fields` array: `{ "id": "...", "fieldGroups": [ { "id": "...", "fields": [ { "id": "...", "type": "input", "controller": { "type": "input", ... } } ] } ] }`. A top-level `fields` array with no `fieldGroups` wrapper will not render anything.
@@ -84,8 +89,8 @@ Embedded option forms:
 - The embedded form renders only while that option is selected. When the option is deselected, existing embedded responses are cleared after user confirmation.
 - Embedded form translation keys are prefixed with `embeddedForms.<optionId>`; for example `embeddedForms.other.fields.other_text.label`. Note this translation content-key prefix IS plural (`embeddedForms`) even though the config field on the option is singular (`embeddedForm`) — these are two different things; do not confuse them.
 - Embedded form response slots are `embedded.<optionId>.<fieldKey>`; for example `embedded.other.other_text`.
-- Use `create-item` with embedded form config and matching translations when creating a new choice item. For an existing choice option, first call `survey_inspect` with `action: "raw-json"` and the choice item reference; copy the returned survey-root item path (for example `/surveyItems/<choiceIndex>`) rather than constructing a path from `/config`. Then use one `survey-json-patch` operation with one plural `patches` array for every related configuration and translation update until a dedicated typed helper exists.
-- MANDATORY: every embedded form field needs a matching `embeddedForms.<optionId>.fields.<fieldId>.label` translation entry in the SAME operation that creates it. There is no fallback/derived label text — a field without this translation renders with no visible label (only its raw type, e.g. "Input") to respondents. Before returning a create-item or raw-patch result, check that you added exactly one label translation per embedded form field you defined.
+- Use `create-item` with embedded form config and matching translations when creating a new choice item. For an existing choice option, inspect its exact item and option ids and use `set-embedded-form`; its relative form translations are prefixed automatically. If the option is also new, put `add-choice-option` with an explicit id immediately before `set-embedded-form` in the same proposal.
+- MANDATORY: every embedded form field needs a matching `embeddedForms.<optionId>.fields.<fieldId>.label` translation entry when it is introduced. There is no fallback/derived label text — a field without this translation renders its raw key to respondents.
 
 Example "Other, please specify" option:
 
@@ -116,6 +121,7 @@ Example "Other, please specify" option:
 ```
 
 Matching translation keys on the choice item:
+
 - `options.other.label`: "Other"
 - `embeddedForms.other.fields.other_text.label`: "Please specify"
 - Optional placeholder: `embeddedForms.other.fields.other_text.placeholder`
@@ -180,7 +186,11 @@ One `create-item` operation carries the whole item plus every translation it nee
     { "locale": "en", "contentKey": "options.strawberry.label", "plainText": "Strawberry" },
     { "locale": "en", "contentKey": "options.blueberry.label", "plainText": "Blueberry" },
     { "locale": "en", "contentKey": "options.other.label", "plainText": "Other" },
-    { "locale": "en", "contentKey": "embeddedForms.other.fields.other_text.label", "plainText": "Please specify" }
+    {
+      "locale": "en",
+      "contentKey": "embeddedForms.other.fields.other_text.label",
+      "plainText": "Please specify"
+    }
   ]
 }
 ```
@@ -211,7 +221,11 @@ Use `maxSelection: null` for "select all that apply" / checkbox-style questions:
     }
   },
   "translations": [
-    { "locale": "en", "contentKey": "title", "plainText": "Which industries have you worked in? Select all that apply." },
+    {
+      "locale": "en",
+      "contentKey": "title",
+      "plainText": "Which industries have you worked in? Select all that apply."
+    },
     { "locale": "en", "contentKey": "options.healthcare.label", "plainText": "Healthcare" },
     { "locale": "en", "contentKey": "options.education.label", "plainText": "Education" },
     { "locale": "en", "contentKey": "options.food_service.label", "plainText": "Food service" }
@@ -242,9 +256,10 @@ Interactive form question:
 CRITICAL — the item's `config` object has exactly two meaningful keys: `id` and `fieldGroups`. `fieldGroups` sits directly on `config` — never nest it under another wrapper, and never put a top-level `fields` array directly on `config` (fields must be inside a `fieldGroups` entry). Fields need at least one non-empty `fieldGroups` entry with an actual `fields` array to be useful; an empty `fieldGroups: [{ "fields": [] }]` is only a starting scaffold, not a finished item.
 
 Field group config:
+
 - `id`: stable group id.
 - `hasDisplayCondition`: optional boolean used by the editor to mark groups that participate in branching/display logic.
-- `layout`: column counts by container breakpoint, using positive integers 1 through 4.
+- `layout`: column counts by container breakpoint, using integers 1 through 4. These are grid column counts, not field spans; use 1 at every breakpoint for a lone full-width field.
 
 Example field group layout:
 
@@ -258,6 +273,7 @@ Example field group layout:
 ```
 
 Field group translations:
+
 - `fieldGroups.<groupId>.title`
 - `fieldGroups.<groupId>.description`
 
@@ -274,7 +290,16 @@ Field shape:
 }
 ```
 
+`key` is the field's exact response-slot identifier. Choose a stable coding key for the field's
+role within this form item. Do not copy the question wording, duplicate context already present in
+the item key, or add ordering suffixes such as `q1`. For a single-field form, concise keys such as
+`response`, `selection`, `value`, or `other_text` are often appropriate. Keys only need to be unique
+within the form item, so the same general key can be reused in another item. A user can edit the
+field key in the form editor, but changing it also changes the response-slot identifier; any
+expressions that use the old slot must be updated in the same change.
+
 Field types and default controllers:
+
 - `input`: `{ "type": "input", "inputMode": "text" }`
 - `textarea`: `{ "type": "textarea", "rows": 3 }`
 - `number`: `{ "type": "number", "step": 1 }`
@@ -284,6 +309,7 @@ Field types and default controllers:
 - `slider`: `{ "type": "slider", "min": 0, "max": 100, "step": 1, "defaultValue": 50, "showValue": true }`
 
 Supported controller properties by type:
+
 - `input`: `placeholder`, `inputMode`, `autocomplete`
 - `textarea`: `placeholder`, `rows`
 - `number`: `placeholder`, `step`, `unit`, `defaultValue`
@@ -302,6 +328,7 @@ Visible select-option labels do NOT live in the controller config. They live in
 If a select controller option has `id: "minder_7_dagen", value: "minder_7_dagen"`, the visible Dutch label still needs a separate translation such as `fields.<fieldId>.options.minder_7_dagen.label`: "minder dan 7 dagen". Without this translation, respondents see the raw key/value in the dropdown.
 
 Field translation keys:
+
 - `fields.<fieldId>.label`
 - `fields.<fieldId>.description`
 - `fields.<fieldId>.error`

package/dist/references/source-material-surveys.md

@@ -28,6 +28,10 @@ Use this reference when the user asks to implement, recreate, convert, import, o
 - Map supported item types directly. Use `choiceItem` for single choice, multiple choice, and scale-like questions until a dedicated scale item exists.
 - For scale questions, create an ordered `choiceItem` with stable option ids/keys and labels that preserve the endpoints and intermediate labels. Include the scale instruction in `subtitle` or `topContent` when it is not part of the actual question.
 - Use `formItem` for grouped personal data, tables of fields, repeated short inputs, dates, numbers, contact details, or unsupported compound controls.
+- Prefer the supported semantic field type for the respondent value instead of copying the paper
+  form's box layout. Use one `datepicker` with mode `year-month-day` for an ordinary full calendar
+  date; use separate day/month/year fields only when the source measures those components
+  independently or the user requests literal paper-form reproduction.
 - Use choice option embedded forms for choices that include an open field, such as "Other, specify", "Yes, explain", or an option-specific quantity/date/text input.
 - Preserve option-level parenthetical instructions, side notes, and footnote markers. If the current choice option UI has no separate option-description surface, fold short option notes into the visible option label, for example `Uitgenodigde persoon zelf (zie hiervoor de naam op de brief en/of geboortedatum op de voorkant van de vragenlijst)`, and keep markers such as `Iemand anders*`.
 - For sentence-completion options with an embedded input, put the completion cue on the embedded field label, not twice. Source text like `Iemand anders*, namelijk ____`, `Andere bedrijfstak, namelijk ____`, or `Other, please specify ____` should become option label `Iemand anders*` / `Andere bedrijfstak` / `Other` and embedded field label `Namelijk` / `Please specify`.
@@ -53,7 +57,11 @@ Use this reference when the user asks to implement, recreate, convert, import, o
 
 ## Workflow
 
-- For complex source implementation, load item-types and assistant-operations before preparing create-item operations; load rich-text-content before formatted info items; load expressions before complex branching.
+- For complex source implementation, load this source-material reference once, then load item-types
+  with the specific `itemType` needed for the current chunk and assistant-operations for unfamiliar
+  operation shapes. Do not load the combined item-types reference merely because a source contains
+  several types. Load rich-text-content before formatted info items and expressions before complex
+  branching.
 - Use survey_inspect for the root group and long-survey insertion points. Use full outline paging or children lookup; do not guess append indexes from truncated context.
 - Before calling survey_change for a source-derived chunk, do a quick fidelity pass against the source: every question title, option label, option parenthetical, blank/input, section heading, footnote marker, and footnote text in that chunk should either be represented digitally or intentionally omitted as print-only/admin material.
 - If the fidelity pass finds missing details, fix the operations before calling survey_change. Do not knowingly leave cleanup for the user when the source gives enough information to implement it now.

package/dist/references/survey-data-model.md

@@ -44,6 +44,19 @@ Conventions:
 - `key` is the coding key shown in fullKey paths. Sibling keys must be unique and use letters, numbers, underscores, or hyphens.
 - `itemType` must exist in the current editor registry.
 
+Identifier rules apply to every built-in and custom item type:
+- Keep inspected identifiers byte-for-byte exact when displaying, explaining, comparing, or
+  reusing them. Do not replace separators, split camelCase, change capitalization, or substitute
+  visible labels.
+- Choose new ids and keys for stable data roles, not the current wording or position. Avoid names
+  such as `question_about_apples` or suffixes such as `q1`; labels and question text can change
+  without changing durable identities.
+- Do not silently derive one configured identifier from another. If a required identifier is
+  omitted and a typed operation generates it, inspect the result before using it in another
+  reference.
+- Custom item response slots come from that item's registered capability. Preserve their exact
+  slot ids just like built-in slots.
+
 Optional fields:
 - `metadata`: string map. `metadata.itemLabel` is the internal editor label, not respondent-visible text. `metadata.editorItemColor` stores the editor item color as a hex string such as `#0369a1`.
 - `config`: item-type-specific configuration. Many item types need config; simple structural/content items can be sparse.

package/dist/request-context-BDBw4-Gw.mjs

@@ -0,0 +1,79 @@
+import { B as surveyDocumentVersionSchema, L as surveyAssistantSnapshotPayloadSchema } from "./protocol-7EEgcYja.mjs";
+import { Q as createSurveyAssistantEngineContext } from "./engine-DQrCO_ur.mjs";
+import { defaultSurveyAssistantCapabilitySet } from "./capabilities-default.mjs";
+import { MASTRA_RESOURCE_ID_KEY, MASTRA_THREAD_ID_KEY, RequestContext } from "@mastra/core/request-context";
+//#region src/server/request-context.ts
+const parseSurveyAssistantSnapshot = (value) => {
+	if (value === void 0 || value === null) return null;
+	return surveyAssistantSnapshotPayloadSchema.parse(value);
+};
+const parseSurveyAssistantPreviousSettledVersion = (value) => {
+	if (value === void 0 || value === null) return null;
+	return surveyDocumentVersionSchema.parse(value);
+};
+const deriveSurveyAssistantDocumentTransition = ({ current, previous }) => {
+	if (!current) return void 0;
+	if (!previous) return { status: "no-baseline" };
+	const previousHistoryIndex = previous.historyIndex;
+	const currentHistoryIndex = current.version.historyIndex;
+	if (previous.sessionId !== current.version.sessionId) return {
+		status: "session-changed",
+		previousHistoryIndex,
+		currentHistoryIndex
+	};
+	const capabilitiesChanged = previous.capabilityDigest !== current.version.capabilityDigest;
+	if (previous.contentHash === current.version.contentHash) return {
+		status: "unchanged",
+		previousHistoryIndex,
+		currentHistoryIndex,
+		capabilitiesChanged
+	};
+	const historyDirection = currentHistoryIndex > previousHistoryIndex ? "forward" : currentHistoryIndex < previousHistoryIndex ? "backward" : "same-index";
+	return {
+		status: "changed",
+		previousHistoryIndex,
+		currentHistoryIndex,
+		historyDirection,
+		recordedSources: historyDirection === "forward" ? [...new Set((current.ui.history?.recent ?? []).filter((entry) => entry.index > previousHistoryIndex && entry.index <= currentHistoryIndex).flatMap((entry) => entry.source ? [entry.source] : []))] : [],
+		capabilitiesChanged
+	};
+};
+const buildSurveyAssistantRequestContext = ({ changeCollector, identity, snapshot, previousSettledVersion = null, trustedCapabilities = defaultSurveyAssistantCapabilitySet, attachmentAccess, modelAttachments = [], modelSelection }) => {
+	const requestContext = new RequestContext();
+	requestContext.set("invocation", { kind: "chat" });
+	requestContext.set("turnId", changeCollector.turnId);
+	requestContext.set("changeCollector", changeCollector);
+	requestContext.set("identity", identity);
+	if (identity.authority === "authenticated-host") {
+		requestContext.set("authenticatedResourceId", identity.resourceId);
+		requestContext.set("authorizedThreadId", identity.threadId);
+	}
+	requestContext.set(MASTRA_RESOURCE_ID_KEY, identity.resourceId);
+	requestContext.set(MASTRA_THREAD_ID_KEY, identity.threadId);
+	const documentTransition = deriveSurveyAssistantDocumentTransition({
+		current: snapshot,
+		previous: previousSettledVersion
+	});
+	if (documentTransition) requestContext.set("documentTransition", documentTransition);
+	if (attachmentAccess && attachmentAccess.documents.length > 0) requestContext.set("attachmentAccess", attachmentAccess);
+	if (modelAttachments.length > 0) requestContext.set("modelAttachments", modelAttachments);
+	if (modelSelection) requestContext.set("modelSelection", modelSelection);
+	if (!snapshot) return requestContext;
+	const engineContext = createSurveyAssistantEngineContext(snapshot, trustedCapabilities);
+	requestContext.set("documentSnapshot", snapshot);
+	requestContext.set("engineContext", engineContext);
+	return requestContext;
+};
+const requireSurveyAssistantTurnState = (requestContext) => {
+	const turnId = requestContext?.get("turnId");
+	const changeCollector = requestContext?.get("changeCollector");
+	if (!turnId || !changeCollector || changeCollector.turnId !== turnId) throw new Error("Survey assistant turn context is unavailable or inconsistent.");
+	return {
+		turnId,
+		changeCollector
+	};
+};
+//#endregion
+export { requireSurveyAssistantTurnState as a, parseSurveyAssistantSnapshot as i, deriveSurveyAssistantDocumentTransition as n, parseSurveyAssistantPreviousSettledVersion as r, buildSurveyAssistantRequestContext as t };
+
+//# sourceMappingURL=request-context-BDBw4-Gw.mjs.map

package/dist/request-context-BDBw4-Gw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context-BDBw4-Gw.mjs","names":[],"sources":["../src/server/request-context.ts"],"sourcesContent":["import {\n  MASTRA_RESOURCE_ID_KEY,\n  MASTRA_THREAD_ID_KEY,\n  RequestContext,\n} from \"@mastra/core/request-context\";\nimport {\n  surveyAssistantSnapshotPayloadSchema,\n  surveyDocumentVersionSchema,\n  type SurveyDocumentSnapshot,\n  type SurveyDocumentVersion,\n} from \"../protocol\";\nimport {\n  createSurveyAssistantEngineContext,\n  TurnChangeCollector,\n  type SurveyAssistantCapabilitySet,\n  type SurveyAssistantEngineContext,\n} from \"../engine\";\nimport { defaultSurveyAssistantCapabilitySet } from \"../capabilities/default\";\nimport type {\n  SurveyAssistantAttachmentAccess,\n  SurveyAssistantModelAttachment,\n} from \"./thread-documents\";\n\nexport interface SurveyAssistantInvocationContext {\n  kind: \"chat\";\n}\n\nexport interface SurveyAssistantIdentityContext {\n  authority: \"experimental-client-request\" | \"authenticated-host\";\n  resourceId: string;\n  surveyId?: string;\n  threadId: string;\n}\n\nexport interface SurveyAssistantModelSelection {\n  id: string;\n  model: string;\n}\n\nexport type SurveyAssistantDocumentTransition =\n  | { status: \"no-baseline\" }\n  | {\n      status: \"session-changed\";\n      previousHistoryIndex: number;\n      currentHistoryIndex: number;\n    }\n  | {\n      status: \"unchanged\";\n      previousHistoryIndex: number;\n      currentHistoryIndex: number;\n      capabilitiesChanged: boolean;\n    }\n  | {\n      status: \"changed\";\n      previousHistoryIndex: number;\n      currentHistoryIndex: number;\n      historyDirection: \"backward\" | \"forward\" | \"same-index\";\n      recordedSources: Array<\"user\" | \"system\" | \"assistant\">;\n      capabilitiesChanged: boolean;\n    };\n\nexport interface SurveyAssistantRequestContext {\n  invocation: SurveyAssistantInvocationContext;\n  turnId: string;\n  changeCollector: TurnChangeCollector;\n  identity: SurveyAssistantIdentityContext;\n  authenticatedResourceId?: string;\n  authorizedThreadId?: string;\n  applyPolicy?: \"auto\" | \"review\" | \"deny\";\n  mastra__resourceId?: string;\n  mastra__threadId?: string;\n  documentTransition?: SurveyAssistantDocumentTransition;\n  engineContext?: SurveyAssistantEngineContext;\n  documentSnapshot?: SurveyDocumentSnapshot;\n  modelAttachments?: SurveyAssistantModelAttachment[];\n  attachmentAccess?: SurveyAssistantAttachmentAccess;\n  modelSelection?: SurveyAssistantModelSelection;\n}\n\nexport const parseSurveyAssistantSnapshot = (value: unknown): SurveyDocumentSnapshot | null => {\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  return surveyAssistantSnapshotPayloadSchema.parse(value);\n};\n\nexport const parseSurveyAssistantPreviousSettledVersion = (\n  value: unknown,\n): SurveyDocumentVersion | null => {\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  return surveyDocumentVersionSchema.parse(value);\n};\n\nexport const deriveSurveyAssistantDocumentTransition = ({\n  current,\n  previous,\n}: {\n  current: SurveyDocumentSnapshot | null;\n  previous: SurveyDocumentVersion | null;\n}): SurveyAssistantDocumentTransition | undefined => {\n  if (!current) return undefined;\n  if (!previous) return { status: \"no-baseline\" };\n\n  const previousHistoryIndex = previous.historyIndex;\n  const currentHistoryIndex = current.version.historyIndex;\n  if (previous.sessionId !== current.version.sessionId) {\n    return {\n      status: \"session-changed\",\n      previousHistoryIndex,\n      currentHistoryIndex,\n    };\n  }\n\n  const capabilitiesChanged = previous.capabilityDigest !== current.version.capabilityDigest;\n  if (previous.contentHash === current.version.contentHash) {\n    return {\n      status: \"unchanged\",\n      previousHistoryIndex,\n      currentHistoryIndex,\n      capabilitiesChanged,\n    };\n  }\n\n  const historyDirection =\n    currentHistoryIndex > previousHistoryIndex\n      ? \"forward\"\n      : currentHistoryIndex < previousHistoryIndex\n        ? \"backward\"\n        : \"same-index\";\n  const recordedSources =\n    historyDirection === \"forward\"\n      ? [\n          ...new Set(\n            (current.ui.history?.recent ?? [])\n              .filter(\n                (entry) => entry.index > previousHistoryIndex && entry.index <= currentHistoryIndex,\n              )\n              .flatMap((entry) => (entry.source ? [entry.source] : [])),\n          ),\n        ]\n      : [];\n\n  return {\n    status: \"changed\",\n    previousHistoryIndex,\n    currentHistoryIndex,\n    historyDirection,\n    recordedSources,\n    capabilitiesChanged,\n  };\n};\n\nexport const buildSurveyAssistantRequestContext = ({\n  changeCollector,\n  identity,\n  snapshot,\n  previousSettledVersion = null,\n  trustedCapabilities = defaultSurveyAssistantCapabilitySet,\n  attachmentAccess,\n  modelAttachments = [],\n  modelSelection,\n}: {\n  changeCollector: TurnChangeCollector;\n  identity: SurveyAssistantIdentityContext;\n  snapshot: SurveyDocumentSnapshot | null;\n  previousSettledVersion?: SurveyDocumentVersion | null;\n  trustedCapabilities?: SurveyAssistantCapabilitySet;\n  attachmentAccess?: SurveyAssistantAttachmentAccess;\n  modelAttachments?: SurveyAssistantModelAttachment[];\n  modelSelection?: SurveyAssistantModelSelection;\n}): RequestContext<SurveyAssistantRequestContext> => {\n  const requestContext = new RequestContext<SurveyAssistantRequestContext>();\n\n  requestContext.set(\"invocation\", { kind: \"chat\" });\n  requestContext.set(\"turnId\", changeCollector.turnId);\n  requestContext.set(\"changeCollector\", changeCollector);\n  requestContext.set(\"identity\", identity);\n  if (identity.authority === \"authenticated-host\") {\n    requestContext.set(\"authenticatedResourceId\", identity.resourceId);\n    requestContext.set(\"authorizedThreadId\", identity.threadId);\n  }\n  requestContext.set(MASTRA_RESOURCE_ID_KEY, identity.resourceId);\n  requestContext.set(MASTRA_THREAD_ID_KEY, identity.threadId);\n  const documentTransition = deriveSurveyAssistantDocumentTransition({\n    current: snapshot,\n    previous: previousSettledVersion,\n  });\n  if (documentTransition) {\n    requestContext.set(\"documentTransition\", documentTransition);\n  }\n  if (attachmentAccess && attachmentAccess.documents.length > 0) {\n    requestContext.set(\"attachmentAccess\", attachmentAccess);\n  }\n  if (modelAttachments.length > 0) {\n    requestContext.set(\"modelAttachments\", modelAttachments);\n  }\n  if (modelSelection) {\n    requestContext.set(\"modelSelection\", modelSelection);\n  }\n\n  if (!snapshot) {\n    return requestContext;\n  }\n\n  const engineContext = createSurveyAssistantEngineContext(snapshot, trustedCapabilities);\n  requestContext.set(\"documentSnapshot\", snapshot);\n  requestContext.set(\"engineContext\", engineContext);\n\n  return requestContext;\n};\n\nexport const requireSurveyAssistantTurnState = (\n  requestContext: RequestContext<SurveyAssistantRequestContext> | undefined,\n) => {\n  const turnId = requestContext?.get(\"turnId\");\n  const changeCollector = requestContext?.get(\"changeCollector\");\n  if (!turnId || !changeCollector || changeCollector.turnId !== turnId) {\n    throw new Error(\"Survey assistant turn context is unavailable or inconsistent.\");\n  }\n\n  return { turnId, changeCollector };\n};\n"],"mappings":";;;;;AA+EA,MAAa,gCAAgC,UAAkD;AAC7F,KAAI,UAAU,KAAA,KAAa,UAAU,KACnC,QAAO;AAGT,QAAO,qCAAqC,MAAM,MAAM;;AAG1D,MAAa,8CACX,UACiC;AACjC,KAAI,UAAU,KAAA,KAAa,UAAU,KACnC,QAAO;AAGT,QAAO,4BAA4B,MAAM,MAAM;;AAGjD,MAAa,2CAA2C,EACtD,SACA,eAImD;AACnD,KAAI,CAAC,QAAS,QAAO,KAAA;AACrB,KAAI,CAAC,SAAU,QAAO,EAAE,QAAQ,eAAe;CAE/C,MAAM,uBAAuB,SAAS;CACtC,MAAM,sBAAsB,QAAQ,QAAQ;AAC5C,KAAI,SAAS,cAAc,QAAQ,QAAQ,UACzC,QAAO;EACL,QAAQ;EACR;EACA;EACD;CAGH,MAAM,sBAAsB,SAAS,qBAAqB,QAAQ,QAAQ;AAC1E,KAAI,SAAS,gBAAgB,QAAQ,QAAQ,YAC3C,QAAO;EACL,QAAQ;EACR;EACA;EACA;EACD;CAGH,MAAM,mBACJ,sBAAsB,uBAClB,YACA,sBAAsB,uBACpB,aACA;AAcR,QAAO;EACL,QAAQ;EACR;EACA;EACA;EACA,iBAjBA,qBAAqB,YACjB,CACE,GAAG,IAAI,KACJ,QAAQ,GAAG,SAAS,UAAU,EAAE,EAC9B,QACE,UAAU,MAAM,QAAQ,wBAAwB,MAAM,SAAS,oBACjE,CACA,SAAS,UAAW,MAAM,SAAS,CAAC,MAAM,OAAO,GAAG,EAAE,CAAE,CAC5D,CACF,GACD,EAAE;EAQN;EACD;;AAGH,MAAa,sCAAsC,EACjD,iBACA,UACA,UACA,yBAAyB,MACzB,sBAAsB,qCACtB,kBACA,mBAAmB,EAAE,EACrB,qBAUmD;CACnD,MAAM,iBAAiB,IAAI,gBAA+C;AAE1E,gBAAe,IAAI,cAAc,EAAE,MAAM,QAAQ,CAAC;AAClD,gBAAe,IAAI,UAAU,gBAAgB,OAAO;AACpD,gBAAe,IAAI,mBAAmB,gBAAgB;AACtD,gBAAe,IAAI,YAAY,SAAS;AACxC,KAAI,SAAS,cAAc,sBAAsB;AAC/C,iBAAe,IAAI,2BAA2B,SAAS,WAAW;AAClE,iBAAe,IAAI,sBAAsB,SAAS,SAAS;;AAE7D,gBAAe,IAAI,wBAAwB,SAAS,WAAW;AAC/D,gBAAe,IAAI,sBAAsB,SAAS,SAAS;CAC3D,MAAM,qBAAqB,wCAAwC;EACjE,SAAS;EACT,UAAU;EACX,CAAC;AACF,KAAI,mBACF,gBAAe,IAAI,sBAAsB,mBAAmB;AAE9D,KAAI,oBAAoB,iBAAiB,UAAU,SAAS,EAC1D,gBAAe,IAAI,oBAAoB,iBAAiB;AAE1D,KAAI,iBAAiB,SAAS,EAC5B,gBAAe,IAAI,oBAAoB,iBAAiB;AAE1D,KAAI,eACF,gBAAe,IAAI,kBAAkB,eAAe;AAGtD,KAAI,CAAC,SACH,QAAO;CAGT,MAAM,gBAAgB,mCAAmC,UAAU,oBAAoB;AACvF,gBAAe,IAAI,oBAAoB,SAAS;AAChD,gBAAe,IAAI,iBAAiB,cAAc;AAElD,QAAO;;AAGT,MAAa,mCACX,mBACG;CACH,MAAM,SAAS,gBAAgB,IAAI,SAAS;CAC5C,MAAM,kBAAkB,gBAAgB,IAAI,kBAAkB;AAC9D,KAAI,CAAC,UAAU,CAAC,mBAAmB,gBAAgB,WAAW,OAC5D,OAAM,IAAI,MAAM,gEAAgE;AAGlF,QAAO;EAAE;EAAQ;EAAiB"}

package/dist/request-guardrails-h4t6u8mP.mjs

@@ -0,0 +1,129 @@
+//#region src/server/request-guardrails.ts
+const SURVEY_ASSISTANT_MAX_REQUEST_BYTES = 20 * 1024 * 1024;
+const SURVEY_ASSISTANT_MAX_MESSAGES = 32;
+const SURVEY_ASSISTANT_MAX_ATTACHMENTS = 4;
+const SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES = 5 * 1024 * 1024;
+const SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES = 12 * 1024 * 1024;
+const SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS = 64e3;
+const SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS = 255;
+const SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES = new Set([
+	"application/pdf",
+	"image/gif",
+	"image/jpeg",
+	"image/png",
+	"image/webp"
+]);
+const SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS = Object.freeze({
+	acceptedAttachmentTypes: SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES,
+	maxAttachmentBytes: SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES,
+	maxAttachmentNameChars: 255,
+	maxAttachments: 4,
+	maxMessages: 32,
+	maxRequestBytes: SURVEY_ASSISTANT_MAX_REQUEST_BYTES,
+	maxTextPartChars: SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS,
+	maxTotalAttachmentBytes: SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES
+});
+var SurveyAssistantRequestError = class extends Error {
+	status;
+	constructor(message, status = 400) {
+		super(message);
+		this.name = "SurveyAssistantRequestError";
+		this.status = status;
+	}
+};
+const attachmentSignatures = {
+	"application/pdf": (bytes) => bytes[0] === 37 && bytes[1] === 80 && bytes[2] === 68 && bytes[3] === 70,
+	"image/gif": (bytes) => String.fromCharCode(...bytes.slice(0, 6)) === "GIF87a" || String.fromCharCode(...bytes.slice(0, 6)) === "GIF89a",
+	"image/jpeg": (bytes) => bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255,
+	"image/png": (bytes) => [
+		137,
+		80,
+		78,
+		71,
+		13,
+		10,
+		26,
+		10
+	].every((value, index) => bytes[index] === value),
+	"image/webp": (bytes) => String.fromCharCode(...bytes.slice(0, 4)) === "RIFF" && String.fromCharCode(...bytes.slice(8, 12)) === "WEBP"
+};
+const decodeBase64Prefix = (payload) => {
+	try {
+		const binary = atob(payload.slice(0, 24));
+		return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+	} catch {
+		throw new SurveyAssistantRequestError("The survey assistant attachment is malformed.");
+	}
+};
+const getDataUrlBytes = (url, expectedMediaType) => {
+	const match = /^data:([^;,]+);base64,([A-Za-z0-9+/]*={0,2})$/.exec(url);
+	if (!match) throw new SurveyAssistantRequestError("Attachments must be base64 data URLs.");
+	if (match[1]?.toLowerCase() !== expectedMediaType.toLowerCase()) throw new SurveyAssistantRequestError("Attachment media type does not match its data URL.");
+	const payload = match[2] ?? "";
+	const signatureMatches = attachmentSignatures[expectedMediaType.toLowerCase()];
+	if (signatureMatches && !signatureMatches(decodeBase64Prefix(payload))) throw new SurveyAssistantRequestError("Attachment content does not match its declared media type.");
+	const padding = payload.endsWith("==") ? 2 : payload.endsWith("=") ? 1 : 0;
+	return Math.max(0, Math.floor(payload.length * 3 / 4) - padding);
+};
+const validateSurveyAssistantMessages = (value, limits = SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS) => {
+	if (!Array.isArray(value) || value.length === 0) throw new SurveyAssistantRequestError("A survey assistant message is required.");
+	if (value.length > limits.maxMessages) throw new SurveyAssistantRequestError("The survey assistant request contains too many messages.");
+	if (value.length !== 1 || value[0]?.role !== "user") throw new SurveyAssistantRequestError("The survey assistant request must contain only the current user message.");
+	let attachmentCount = 0;
+	let totalAttachmentBytes = 0;
+	for (const message of value) {
+		if (!message || typeof message !== "object" || !Array.isArray(message.parts)) throw new SurveyAssistantRequestError("The survey assistant messages are malformed.");
+		for (const part of message.parts) {
+			if (!part || typeof part !== "object" || typeof part.type !== "string") throw new SurveyAssistantRequestError("A survey assistant message part is malformed.");
+			if (part.type === "text") {
+				if (typeof part.text !== "string") throw new SurveyAssistantRequestError("A survey assistant text part is malformed.");
+				if (part.text.length > limits.maxTextPartChars) throw new SurveyAssistantRequestError("A survey assistant message is too long.");
+				continue;
+			}
+			if (part.type !== "file") throw new SurveyAssistantRequestError("The survey assistant message part is not supported.");
+			attachmentCount += 1;
+			if (attachmentCount > limits.maxAttachments) throw new SurveyAssistantRequestError("The survey assistant request has too many attachments.");
+			if (typeof part.mediaType !== "string" || !limits.acceptedAttachmentTypes.has(part.mediaType.toLowerCase())) throw new SurveyAssistantRequestError("The survey assistant attachment type is not supported.");
+			if (typeof part.url !== "string") throw new SurveyAssistantRequestError("The survey assistant attachment is malformed.");
+			if (part.filename !== void 0 && (typeof part.filename !== "string" || part.filename.length > limits.maxAttachmentNameChars || /[\u0000-\u001f\u007f]/.test(part.filename))) throw new SurveyAssistantRequestError("The survey assistant attachment name is invalid.");
+			const bytes = getDataUrlBytes(part.url, part.mediaType);
+			if (bytes > limits.maxAttachmentBytes) throw new SurveyAssistantRequestError("A survey assistant attachment is too large.");
+			totalAttachmentBytes += bytes;
+			if (totalAttachmentBytes > limits.maxTotalAttachmentBytes) throw new SurveyAssistantRequestError("The survey assistant attachments are too large in total.");
+		}
+	}
+	return value;
+};
+const readSurveyAssistantRequestJson = async (request, maxRequestBytes = SURVEY_ASSISTANT_MAX_REQUEST_BYTES) => {
+	const declaredLength = Number(request.headers.get("content-length"));
+	if (Number.isFinite(declaredLength) && declaredLength > maxRequestBytes) throw new SurveyAssistantRequestError("The survey assistant request is too large.", 413);
+	const reader = request.body?.getReader();
+	const chunks = [];
+	let totalBytes = 0;
+	if (reader) while (true) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		totalBytes += value.byteLength;
+		if (totalBytes > maxRequestBytes) {
+			await reader.cancel();
+			throw new SurveyAssistantRequestError("The survey assistant request is too large.", 413);
+		}
+		chunks.push(value);
+	}
+	const bytes = new Uint8Array(totalBytes);
+	let offset = 0;
+	for (const chunk of chunks) {
+		bytes.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	const text = new TextDecoder().decode(bytes);
+	try {
+		return JSON.parse(text);
+	} catch {
+		throw new SurveyAssistantRequestError("The survey assistant request is not valid JSON.");
+	}
+};
+//#endregion
+export { SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS as a, SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS as c, readSurveyAssistantRequestJson as d, validateSurveyAssistantMessages as f, SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES as i, SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES as l, SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS as n, SURVEY_ASSISTANT_MAX_MESSAGES as o, SURVEY_ASSISTANT_MAX_ATTACHMENTS as r, SURVEY_ASSISTANT_MAX_REQUEST_BYTES as s, SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES as t, SurveyAssistantRequestError as u };
+
+//# sourceMappingURL=request-guardrails-h4t6u8mP.mjs.map

package/dist/request-guardrails-h4t6u8mP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-guardrails-h4t6u8mP.mjs","names":[],"sources":["../src/server/request-guardrails.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\n\nexport const SURVEY_ASSISTANT_MAX_REQUEST_BYTES = 20 * 1024 * 1024;\nexport const SURVEY_ASSISTANT_MAX_MESSAGES = 32;\nexport const SURVEY_ASSISTANT_MAX_ATTACHMENTS = 4;\nexport const SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES = 5 * 1024 * 1024;\nexport const SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES = 12 * 1024 * 1024;\nexport const SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS = 64_000;\nexport const SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS = 255;\n\nexport const SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES = new Set<string>([\n  \"application/pdf\",\n  \"image/gif\",\n  \"image/jpeg\",\n  \"image/png\",\n  \"image/webp\",\n]);\n\nexport interface SurveyAssistantRequestLimits {\n  acceptedAttachmentTypes: ReadonlySet<string>;\n  maxAttachmentBytes: number;\n  maxAttachmentNameChars: number;\n  maxAttachments: number;\n  maxMessages: number;\n  maxRequestBytes: number;\n  maxTextPartChars: number;\n  maxTotalAttachmentBytes: number;\n}\n\nexport const SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS: SurveyAssistantRequestLimits = Object.freeze({\n  acceptedAttachmentTypes: SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES,\n  maxAttachmentBytes: SURVEY_ASSISTANT_MAX_ATTACHMENT_BYTES,\n  maxAttachmentNameChars: SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS,\n  maxAttachments: SURVEY_ASSISTANT_MAX_ATTACHMENTS,\n  maxMessages: SURVEY_ASSISTANT_MAX_MESSAGES,\n  maxRequestBytes: SURVEY_ASSISTANT_MAX_REQUEST_BYTES,\n  maxTextPartChars: SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS,\n  maxTotalAttachmentBytes: SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES,\n});\n\nexport class SurveyAssistantRequestError extends Error {\n  readonly status: number;\n\n  constructor(message: string, status = 400) {\n    super(message);\n    this.name = \"SurveyAssistantRequestError\";\n    this.status = status;\n  }\n}\n\nconst attachmentSignatures: Record<string, (bytes: Uint8Array) => boolean> = {\n  \"application/pdf\": (bytes) =>\n    bytes[0] === 0x25 && bytes[1] === 0x50 && bytes[2] === 0x44 && bytes[3] === 0x46,\n  \"image/gif\": (bytes) =>\n    String.fromCharCode(...bytes.slice(0, 6)) === \"GIF87a\" ||\n    String.fromCharCode(...bytes.slice(0, 6)) === \"GIF89a\",\n  \"image/jpeg\": (bytes) => bytes[0] === 0xff && bytes[1] === 0xd8 && bytes[2] === 0xff,\n  \"image/png\": (bytes) =>\n    [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a].every(\n      (value, index) => bytes[index] === value,\n    ),\n  \"image/webp\": (bytes) =>\n    String.fromCharCode(...bytes.slice(0, 4)) === \"RIFF\" &&\n    String.fromCharCode(...bytes.slice(8, 12)) === \"WEBP\",\n};\n\nconst decodeBase64Prefix = (payload: string) => {\n  try {\n    const binary = atob(payload.slice(0, 24));\n    return Uint8Array.from(binary, (character) => character.charCodeAt(0));\n  } catch {\n    throw new SurveyAssistantRequestError(\"The survey assistant attachment is malformed.\");\n  }\n};\n\nconst getDataUrlBytes = (url: string, expectedMediaType: string): number => {\n  const match = /^data:([^;,]+);base64,([A-Za-z0-9+/]*={0,2})$/.exec(url);\n  if (!match) {\n    throw new SurveyAssistantRequestError(\"Attachments must be base64 data URLs.\");\n  }\n  if (match[1]?.toLowerCase() !== expectedMediaType.toLowerCase()) {\n    throw new SurveyAssistantRequestError(\"Attachment media type does not match its data URL.\");\n  }\n\n  const payload = match[2] ?? \"\";\n  const signatureMatches = attachmentSignatures[expectedMediaType.toLowerCase()];\n  if (signatureMatches && !signatureMatches(decodeBase64Prefix(payload))) {\n    throw new SurveyAssistantRequestError(\n      \"Attachment content does not match its declared media type.\",\n    );\n  }\n  const padding = payload.endsWith(\"==\") ? 2 : payload.endsWith(\"=\") ? 1 : 0;\n  return Math.max(0, Math.floor((payload.length * 3) / 4) - padding);\n};\n\nexport const validateSurveyAssistantMessages = (\n  value: unknown,\n  limits: SurveyAssistantRequestLimits = SURVEY_ASSISTANT_DEFAULT_REQUEST_LIMITS,\n): UIMessage[] => {\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new SurveyAssistantRequestError(\"A survey assistant message is required.\");\n  }\n  if (value.length > limits.maxMessages) {\n    throw new SurveyAssistantRequestError(\n      \"The survey assistant request contains too many messages.\",\n    );\n  }\n  if (value.length !== 1 || value[0]?.role !== \"user\") {\n    throw new SurveyAssistantRequestError(\n      \"The survey assistant request must contain only the current user message.\",\n    );\n  }\n\n  let attachmentCount = 0;\n  let totalAttachmentBytes = 0;\n  for (const message of value) {\n    if (!message || typeof message !== \"object\" || !Array.isArray(message.parts)) {\n      throw new SurveyAssistantRequestError(\"The survey assistant messages are malformed.\");\n    }\n\n    for (const part of message.parts) {\n      if (!part || typeof part !== \"object\" || typeof part.type !== \"string\") {\n        throw new SurveyAssistantRequestError(\"A survey assistant message part is malformed.\");\n      }\n      if (part.type === \"text\") {\n        if (typeof part.text !== \"string\") {\n          throw new SurveyAssistantRequestError(\"A survey assistant text part is malformed.\");\n        }\n        if (part.text.length > limits.maxTextPartChars) {\n          throw new SurveyAssistantRequestError(\"A survey assistant message is too long.\");\n        }\n        continue;\n      }\n      if (part.type !== \"file\") {\n        throw new SurveyAssistantRequestError(\n          \"The survey assistant message part is not supported.\",\n        );\n      }\n\n      attachmentCount += 1;\n      if (attachmentCount > limits.maxAttachments) {\n        throw new SurveyAssistantRequestError(\n          \"The survey assistant request has too many attachments.\",\n        );\n      }\n      if (\n        typeof part.mediaType !== \"string\" ||\n        !limits.acceptedAttachmentTypes.has(part.mediaType.toLowerCase())\n      ) {\n        throw new SurveyAssistantRequestError(\n          \"The survey assistant attachment type is not supported.\",\n        );\n      }\n      if (typeof part.url !== \"string\") {\n        throw new SurveyAssistantRequestError(\"The survey assistant attachment is malformed.\");\n      }\n      if (\n        part.filename !== undefined &&\n        (typeof part.filename !== \"string\" ||\n          part.filename.length > limits.maxAttachmentNameChars ||\n          /[\\u0000-\\u001f\\u007f]/.test(part.filename))\n      ) {\n        throw new SurveyAssistantRequestError(\"The survey assistant attachment name is invalid.\");\n      }\n\n      const bytes = getDataUrlBytes(part.url, part.mediaType);\n      if (bytes > limits.maxAttachmentBytes) {\n        throw new SurveyAssistantRequestError(\"A survey assistant attachment is too large.\");\n      }\n      totalAttachmentBytes += bytes;\n      if (totalAttachmentBytes > limits.maxTotalAttachmentBytes) {\n        throw new SurveyAssistantRequestError(\n          \"The survey assistant attachments are too large in total.\",\n        );\n      }\n    }\n  }\n\n  return value as UIMessage[];\n};\n\nexport const readSurveyAssistantRequestJson = async (\n  request: Request,\n  maxRequestBytes = SURVEY_ASSISTANT_MAX_REQUEST_BYTES,\n): Promise<unknown> => {\n  const declaredLength = Number(request.headers.get(\"content-length\"));\n  if (Number.isFinite(declaredLength) && declaredLength > maxRequestBytes) {\n    throw new SurveyAssistantRequestError(\"The survey assistant request is too large.\", 413);\n  }\n\n  const reader = request.body?.getReader();\n  const chunks: Uint8Array[] = [];\n  let totalBytes = 0;\n  if (reader) {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      totalBytes += value.byteLength;\n      if (totalBytes > maxRequestBytes) {\n        await reader.cancel();\n        throw new SurveyAssistantRequestError(\"The survey assistant request is too large.\", 413);\n      }\n      chunks.push(value);\n    }\n  }\n  const bytes = new Uint8Array(totalBytes);\n  let offset = 0;\n  for (const chunk of chunks) {\n    bytes.set(chunk, offset);\n    offset += chunk.byteLength;\n  }\n  const text = new TextDecoder().decode(bytes);\n\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    throw new SurveyAssistantRequestError(\"The survey assistant request is not valid JSON.\");\n  }\n};\n"],"mappings":"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"}

package/dist/server-agent.d.mts

@@ -1,5 +1,5 @@
-import { a as SurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID } from "./constants-Jw0k8ojS.mjs";
-import { n as surveyAssistantTools } from "./index-MpEMQzTm.mjs";
+import { o as SurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID } from "./constants-56jf_4ls.mjs";
+import { n as surveyAssistantTools } from "./index-B_x2IYi7.mjs";
 import * as _$_mastra_core_agent0 from "@mastra/core/agent";
 import { Agent, AgentConfig } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
@@ -77,6 +77,8 @@ declare const createSurveyAssistantAgent: ({
   survey_authoring_reference: _$_mastra_core_tools0.Tool<{
     topic: string;
     itemType?: string | undefined;
+    operationKind?: string | undefined;
+    detail?: "full" | "compact" | undefined;
     reason?: string | undefined;
   }, {
     ok: boolean;
@@ -84,6 +86,8 @@ declare const createSurveyAssistantAgent: ({
     title: string;
     content: string;
     itemType?: string | undefined;
+    operationKind?: string | undefined;
+    detail?: "full" | "compact" | undefined;
   }, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_authoring_reference", unknown>;
   survey_expression: _$_mastra_core_tools0.Tool<{
     action: "context" | "prepare";

package/dist/server-agent.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server-agent.d.mts","names":[],"sources":["../src/server/agent.ts"],"mappings":";;;;;;;;;cAuBa,wCAAA,EAA0C,cAAA;AAAA,KAuNlD,0BAAA,GAA6B,WAAA,QACzB,yBAAA,SACA,oBAAA,aAEP,6BAAA;AAAA,KAGG,4BAAA,GAA+B,WAAA,CAClC,WAAA,CAAY,qBAAA,QAA6B,MAAA;AAAA,KAyC/B,yCAAA,GAA4C,OAAA,CACtD,4BAAA;AAAA,KAIG,8CAAA,GAAiD,OAAA,CACpD,IAAA,CAAK,yCAAA;EAEL,KAAA,EAAO,WAAA,CAAY,yCAAA;AAAA;AAAA,cAGR,8CAAA;EAAA;;;;cAMA,+CAAA;EAAmD,KAAA;EAAA,WAAA;EAAA,UAAA;EAAA,GAAA;AAAA,GAK7D,8CAAA,KAAiD,yCAAA;AAAA,UAkCnC,iCAAA;EACf,KAAA,EAAO,0BAAA;EACP,MAAA,GAAS,0BAAA;EACT,mBAAA,GAAsB,yCAAA;AAAA;AAAA,cAGX,0BAAA;EAA8B,MAAA;EAAA,KAAA;EAAA;AAAA,GAIxC,iCAAA,KAAiC,KAAA,2BAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAA,qBAAA,CAAA,oBAAA"}
+{"version":3,"file":"server-agent.d.mts","names":[],"sources":["../src/server/agent.ts"],"mappings":";;;;;;;;;cAuBa,wCAAA,EAA0C,cAAA;AAAA,KAqPlD,0BAAA,GAA6B,WAAA,QACzB,yBAAA,SACA,oBAAA,aAEP,6BAAA;AAAA,KAGG,4BAAA,GAA+B,WAAA,CAClC,WAAA,CAAY,qBAAA,QAA6B,MAAA;AAAA,KAyC/B,yCAAA,GAA4C,OAAA,CACtD,4BAAA;AAAA,KAIG,8CAAA,GAAiD,OAAA,CACpD,IAAA,CAAK,yCAAA;EAEL,KAAA,EAAO,WAAA,CAAY,yCAAA;AAAA;AAAA,cAGR,8CAAA;EAAA;;;;cAMA,+CAAA;EAAmD,KAAA;EAAA,WAAA;EAAA,UAAA;EAAA,GAAA;AAAA,GAK7D,8CAAA,KAAiD,yCAAA;AAAA,UAkCnC,iCAAA;EACf,KAAA,EAAO,0BAAA;EACP,MAAA,GAAS,0BAAA;EACT,mBAAA,GAAsB,yCAAA;AAAA;AAAA,cAGX,0BAAA;EAA8B,MAAA;EAAA,KAAA;EAAA;AAAA,GAIxC,iCAAA,KAAiC,KAAA,2BAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAA,qBAAA,CAAA,oBAAA"}