@case-framework/survey-assistant 0.7.0 → 0.9.0

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

@@ -1,130 +1,64 @@
-# Survey Data Model
+# Survey data model
 
-## RawSurvey
+The current survey format is schema version **3**. The trusted installed registry supplies every element schema; inspect the current draft and focused operation contracts before constructing payloads. There are no legacy question wrappers or form modes.
 
-A survey JSON object has this shape:
+## Survey and flow
+
+Keep `$schema` and `schemaVersion` unchanged. A survey has `surveyItems`, exactly one root `group`, and optional `maxItemsPerPage`, `metadata`, `templateValues`, `assets`, `translations` and `defaultLocale` (the source language; must be a `translations` key). Flow items are `content`, `group`, or `page-break`. Groups order child item IDs in `config.items`; they may shuffle children. A page break has empty config. Use `reorder-items` with the complete child list or `move-item` with an inspected destination.
+
+Minimal survey document (for understanding the format, not for replacing an existing survey):
 
 ```json
 {
   "$schema": "https://github.com/case-framework/case-survey-toolkit/packages/survey-core/schemas/survey-schema.json",
-  "maxItemsPerPage": { "large": 1, "small": 1 },
-  "surveyItems": [],
-  "assets": {},
-  "metadata": {},
-  "templateValues": {},
+  "schemaVersion": 3,
+  "surveyItems": [
+    {
+      "id": "root",
+      "itemType": "group",
+      "config": { "isRoot": true, "items": [], "shuffleItems": false }
+    }
+  ],
   "translations": {}
 }
 ```
 
-Required fields:
-
-- `$schema`: keep the current schema string; never remove or edit it.
-- `surveyItems`: array of raw survey items.
-
-Optional fields:
-
-- `maxItemsPerPage`: object with numeric `large` and `small` page-size limits.
-- `metadata`: survey-level string map.
-- `templateValues`: reusable expression values; see expressions.md.
-- `assets`: image assets keyed by asset id.
-- `translations`: locale-keyed translated content.
-
-## RawSurveyItem
-
-Minimal item shape:
-
-```json
-{
-  "id": "stable-unique-id",
-  "key": "coding_key",
-  "itemType": "choiceItem"
-}
-```
+`surveyItems` is a flat list. Flow nesting is represented by the ordered child IDs in groups, not nested item objects. Every non-root item belongs to exactly one group. By contrast, elements, layouts, sections and follow-up bodies are nested directly inside their containing content item. Flow parent IDs and composition layout/body destinations are different kinds of targets; inspect the intended destination before editing.
 
-Conventions:
+A content item has optional localized title, subtitle and footer, and `config.body`. It may contain one element (the common case) or several. An element preset inserted into the survey creates a content item containing that element; inserting into a layout adds it to that item. This is the same element definition, with no simple/custom mode transition.
 
-- `id` is globally unique and is the durable reference used by groups, translations, response slots, expressions, and patches.
-- `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.
+## Composition
 
-Identifier rules apply to every built-in and custom item type:
+A body is `{ "blocks": [...] }`. Each block is either:
 
-- 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.
+- A layout: `{ "kind": "layout", "id": "layout-id", "layout": { "mode": "automatic", "maxColumns": 2 }, "elements": [...] }`.
+- A semantic section: `{ "kind": "section", "id": "section-id", "body": { "blocks": [...] } }`.
 
-Optional fields:
+Sections take the full width and structure the body vertically. A section cannot sit in a layout alongside elements, nor contain another section. Its title may be empty while drafting but should be supplied for a useful semantic grouping. Follow-up bodies may also contain sections. No follow-up may contain another follow-up, including through sections or custom elements.
 
-- `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.
-- `validations`: map of validation key to `JsonExpression`.
-- `displayConditions`: item/root and component display expressions.
-- `disabledConditions`: component disabled expressions.
-- `prefills`: configured prefill rules; see expressions.md.
+Layout columns align across rows. Automatic `maxColumns` is an upper bound: available space, minimum element widths and full-width controls determine the actual count. Advanced mode specifies `columns` at `base`, `xs`, `sm`, `md`, and `xl`; use it only for deliberate breakpoint requirements. Elements may set `placement.width` to `auto` or `full` and `placement.minWidthRem`. Radio and checkbox lists, matrices, information and consent require a full row. Dropdowns can share a row and cannot own inline follow-ups.
 
-## Tree Structure
+An element has `kind: "element"`, `id`, `elementType`, and registered `config`, plus optional `visibility`, `disabled`, `placement`, `exportSettings` and `prefills`. Conditions also belong directly to applicable structural owners, including items, sections and options. No condition means visible/enabled. Inspect declared owners before editing a condition.
 
-There must be exactly one root group:
+## Identity and content
 
-```json
-{
-  "itemType": "group",
-  "config": { "isRoot": true, "items": [], "shuffleItems": false }
-}
-```
+IDs are survey-wide stable identities, independent of labels, layout, position, variable names and export codes. Preserve inspected identifiers byte-for-byte. Never infer an ID from a name or humanize it when reusing it. Duplicate editor names are legal. Choose fresh IDs for new owners and slots; preserve them when moving or translating. Custom slots come from the installed definition, not naming guesses.
 
-Groups order children by id in `config.items`. To reorder survey items, patch the parent group item at `/surveyItems/<groupIndex>/config/items`.
+- Items have no `key`. Inspection resolves `editorName` and `breadcrumb` for discovery; neither is an identity. Mutations take exact IDs.
+- Choose new IDs and variable names for stable data roles, not current wording or position. Avoid names such as `question_about_apples` or positional suffixes such as `q1`: labels and order can change without changing durable identities.
+- Do not silently derive one configured identifier from another. When a preset or typed operation generates IDs, inspect its result before using them in another reference.
+- Custom element response slots come from that element's registered capability. Preserve their exact slot IDs just like built-in slots; do not assume that an element ID is also its slot ID.
 
-## Translations And Content
+Element settings and prefills are keyed by its declared slot IDs. Cross-input validation rules live in the content item's `config.validationRules` and target slots in that item. A cross-item move must respect the explicit rule-transfer contract; do not detach referenced targets through raw patches.
 
-Visible text is stored under translations, not usually in item config:
+Respondent content lives at `translations[locale].content[ownerId][role]`. Owners include the item, section, element, option, row, column and validation rule, as declared by their schemas. A move does not relocate translation keys. Use exact localization refs from inspection:
 
 ```json
-{
-  "translations": {
-    "en": {
-      "itemTranslations": {
-        "<itemId>": {
-          "title": { "type": "md", "content": "Question text" }
-        }
-      },
-      "surveyCardContent": {},
-      "navigationContent": {},
-      "validationMessages": {}
-    }
-  }
-}
+{ "scope": "content", "ownerId": "option-other", "role": "label" }
 ```
 
-Content values may be:
-
-- `{ "type": "md", "content": "Text" }`
-- `{ "type": "plain", "content": "Plain text" }`
-- `{ "type": "richText", "version": 1, "doc": { "type": "doc", "blocks": [...] } }`
-
-Important:
-
-- `md` and `plain` content are rendered as plain text with line breaks. Markdown syntax such as `# Heading`, `**bold**`, or `- item` is not parsed into formatting.
-- For unformatted text, use typed translation operations with `plainText`.
-- For formatted content on a surface documented as rendering rich text, use typed translation operations. The model-facing `richTextBlocks` shorthand normalizes to canonical richText `content` wherever the typed translation accepts structured `content`, but structural acceptance alone does not guarantee formatted rendering. See rich-text-content.md.
-- If the user asks for another language or the source material is clearly in another language, write respondent-visible translations under that locale code. A translation operation may introduce a missing locale; do not store Dutch, German, French, etc. text under `en` just because `en` exists.
-
-Common item content keys:
+The item roles are `title`, `subtitle`, `footer`; section roles are `title`, `description`. Element and component roles come from capabilities. Survey wording uses `{ "scope": "survey", "surface": "navigationContent", "contentKey": "..." }`; inspect existing or declared keys.
 
-- `title`: question title or group/page title.
-- `subtitle`: question subtitle.
-- `topContent`: content before the response controls.
-- `bottomContent`: content after the response controls.
-- `cardFooter`: footer inside the question card.
-- `content`: info item body.
+Content is plain text (`plain` or `md`, both rendered without Markdown parsing) or canonical `richText`. Use `update-content` with a ref, locale and exactly one of `plainText` or `content`; `content: null` clears a surface. Rich-text shorthand is normalized before validation. See rich-text-content for supported formatting. Never replace a translation container to edit a leaf, and never put target-language text under the wrong locale.
 
-JSON Patch paths are relative to the survey document root. Do not prefix paths with `/survey`.
-Escape JSON Pointer segments: `/` becomes `~1`, `~` becomes `~0`.
+Item `metadata.itemLabel` and `metadata.editorItemColor` are editor-only. Coding names are also separate from respondent translations. JSON Pointer paths are rooted at the survey, without `/survey`; escape `~` as `~0` and `/` as `~1`. Inspect paths instead of guessing array indexes.

package/dist/{request-context-CG4SWijt.mjs → request-context-KVh8VjgH.mjs}

@@ -1,6 +1,6 @@
-import { H as surveyDocumentVersionSchema, o as surveyAssistantApplyOutcomeSchema, z as surveyAssistantSnapshotPayloadSchema } from "./protocol-BhzQbx81.mjs";
-import { pt as createSurveyAssistantEngineContext } from "./engine-Bo85Oyj0.mjs";
-import { defaultSurveyAssistantCapabilitySet } from "./capabilities-default.mjs";
+import { G as surveyDocumentVersionSchema, H as surveyAssistantSnapshotPayloadSchema, o as surveyAssistantApplyOutcomeSchema } from "./protocol-BQ7uIDYT.mjs";
+import { et as createSurveyAssistantEngineContext } from "./engine-D950TfvC.mjs";
+import { n as defaultSurveyAssistantCapabilitySet } from "./default-D22AKTqE.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) => {
@@ -44,14 +44,9 @@ const deriveSurveyAssistantDocumentTransition = ({ current, previous }) => {
 };
 const buildSurveyAssistantRequestContext = ({ turnDraft, identity, snapshot, previousSettledVersion = null, trustedCapabilities = defaultSurveyAssistantCapabilitySet, attachmentAccess, modelAttachments = [], modelSelection, previousApplyOutcome }) => {
 	const requestContext = new RequestContext();
-	requestContext.set("invocation", { kind: "chat" });
 	requestContext.set("turnId", turnDraft.turnId);
 	requestContext.set("turnDraft", turnDraft);
 	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({
@@ -66,7 +61,6 @@ const buildSurveyAssistantRequestContext = ({ turnDraft, identity, snapshot, pre
 	if (!snapshot) return requestContext;
 	const engineContext = createSurveyAssistantEngineContext(snapshot, trustedCapabilities);
 	turnDraft.initialize(engineContext);
-	requestContext.set("documentSnapshot", snapshot);
 	requestContext.set("engineContext", engineContext);
 	return requestContext;
 };
@@ -88,4 +82,4 @@ const requireSurveyAssistantTurnState = (requestContext) => {
 //#endregion
 export { parseSurveyAssistantPreviousSettledVersion as a, parseSurveyAssistantPreviousApplyOutcome as i, deriveSurveyAssistantDocumentTransition as n, parseSurveyAssistantSnapshot as o, getSurveyAssistantEngineContext as r, requireSurveyAssistantTurnState as s, buildSurveyAssistantRequestContext as t };
 
-//# sourceMappingURL=request-context-CG4SWijt.mjs.map
+//# sourceMappingURL=request-context-KVh8VjgH.mjs.map

package/dist/request-context-KVh8VjgH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context-KVh8VjgH.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 type { OpenAICompatibleConfig } from \"@mastra/core/llm\";\nimport type { AgentExecutionOptions } from \"@mastra/core/agent\";\nimport {\n  surveyAssistantSnapshotPayloadSchema,\n  surveyAssistantApplyOutcomeSchema,\n  surveyDocumentVersionSchema,\n  type SurveyAssistantApplyOutcome,\n  type SurveyDocumentSnapshot,\n  type SurveyDocumentVersion,\n} from \"../protocol\";\nimport {\n  createSurveyAssistantEngineContext,\n  type SurveyAssistantEngineContext,\n} from \"../engine/context\";\nimport type { TurnSurveyDraft } from \"../engine/turn-survey-draft\";\nimport type { SurveyAssistantCapabilitySet } from \"../engine/capabilities\";\nimport { defaultSurveyAssistantCapabilitySet } from \"../capabilities/default\";\nimport type {\n  SurveyAssistantAttachmentAccess,\n  SurveyAssistantModelAttachment,\n} from \"./thread-documents\";\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 | OpenAICompatibleConfig;\n  providerName?: string;\n  providerOptions?: AgentExecutionOptions[\"providerOptions\"];\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  turnId: string;\n  turnDraft: TurnSurveyDraft;\n  identity: SurveyAssistantIdentityContext;\n  mastra__resourceId?: string;\n  mastra__threadId?: string;\n  documentTransition?: SurveyAssistantDocumentTransition;\n  engineContext?: SurveyAssistantEngineContext;\n  modelAttachments?: SurveyAssistantModelAttachment[];\n  attachmentAccess?: SurveyAssistantAttachmentAccess;\n  modelSelection?: SurveyAssistantModelSelection;\n  previousApplyOutcome?: SurveyAssistantApplyOutcome;\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 parseSurveyAssistantPreviousApplyOutcome = (\n  value: unknown,\n): SurveyAssistantApplyOutcome | null => {\n  if (value === undefined || value === null) {\n    return null;\n  }\n\n  return surveyAssistantApplyOutcomeSchema.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  turnDraft,\n  identity,\n  snapshot,\n  previousSettledVersion = null,\n  trustedCapabilities = defaultSurveyAssistantCapabilitySet,\n  attachmentAccess,\n  modelAttachments = [],\n  modelSelection,\n  previousApplyOutcome,\n}: {\n  turnDraft: TurnSurveyDraft;\n  identity: SurveyAssistantIdentityContext;\n  snapshot: SurveyDocumentSnapshot | null;\n  previousSettledVersion?: SurveyDocumentVersion | null;\n  trustedCapabilities?: SurveyAssistantCapabilitySet;\n  attachmentAccess?: SurveyAssistantAttachmentAccess;\n  modelAttachments?: SurveyAssistantModelAttachment[];\n  modelSelection?: SurveyAssistantModelSelection;\n  previousApplyOutcome?: SurveyAssistantApplyOutcome | null;\n}): RequestContext<SurveyAssistantRequestContext> => {\n  const requestContext = new RequestContext<SurveyAssistantRequestContext>();\n\n  requestContext.set(\"turnId\", turnDraft.turnId);\n  requestContext.set(\"turnDraft\", turnDraft);\n  requestContext.set(\"identity\", identity);\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  if (previousApplyOutcome) {\n    requestContext.set(\"previousApplyOutcome\", previousApplyOutcome);\n  }\n\n  if (!snapshot) {\n    return requestContext;\n  }\n\n  const engineContext = createSurveyAssistantEngineContext(snapshot, trustedCapabilities);\n  turnDraft.initialize(engineContext);\n  requestContext.set(\"engineContext\", engineContext);\n\n  return requestContext;\n};\n\n/**\n * Returns the materialized request-local survey state. The immutable\n * engineContext remains available as the turn baseline, while every tool uses\n * this accessor so successful same-turn mutations are immediately visible.\n */\nexport const getSurveyAssistantEngineContext = (\n  requestContext: RequestContext<SurveyAssistantRequestContext> | undefined,\n): SurveyAssistantEngineContext | undefined =>\n  requestContext?.get(\"turnDraft\")?.context ?? requestContext?.get(\"engineContext\");\n\nexport const requireSurveyAssistantTurnState = (\n  requestContext: RequestContext<SurveyAssistantRequestContext> | undefined,\n) => {\n  const turnId = requestContext?.get(\"turnId\");\n  const turnDraft = requestContext?.get(\"turnDraft\");\n  if (!turnId || !turnDraft || turnDraft.turnId !== turnId) {\n    throw new Error(\"Survey assistant turn context is unavailable or inconsistent.\");\n  }\n\n  return { turnId, turnDraft };\n};\n"],"mappings":";;;;;AA6EA,MAAa,gCAAgC,UAAkD;CAC7F,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO;CAGT,OAAO,qCAAqC,MAAM,KAAK;AACzD;AAEA,MAAa,8CACX,UACiC;CACjC,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO;CAGT,OAAO,4BAA4B,MAAM,KAAK;AAChD;AAEA,MAAa,4CACX,UACuC;CACvC,IAAI,UAAU,KAAA,KAAa,UAAU,MACnC,OAAO;CAGT,OAAO,kCAAkC,MAAM,KAAK;AACtD;AAEA,MAAa,2CAA2C,EACtD,SACA,eAImD;CACnD,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,CAAC,UAAU,OAAO,EAAE,QAAQ,cAAc;CAE9C,MAAM,uBAAuB,SAAS;CACtC,MAAM,sBAAsB,QAAQ,QAAQ;CAC5C,IAAI,SAAS,cAAc,QAAQ,QAAQ,WACzC,OAAO;EACL,QAAQ;EACR;EACA;CACF;CAGF,MAAM,sBAAsB,SAAS,qBAAqB,QAAQ,QAAQ;CAC1E,IAAI,SAAS,gBAAgB,QAAQ,QAAQ,aAC3C,OAAO;EACL,QAAQ;EACR;EACA;EACA;CACF;CAGF,MAAM,mBACJ,sBAAsB,uBAClB,YACA,sBAAsB,uBACpB,aACA;CAcR,OAAO;EACL,QAAQ;EACR;EACA;EACA;EACA,iBAjBA,qBAAqB,YACjB,CACE,GAAG,IAAI,KACJ,QAAQ,GAAG,SAAS,UAAU,CAAC,EAAA,CAC7B,QACE,UAAU,MAAM,QAAQ,wBAAwB,MAAM,SAAS,mBAClE,CAAC,CACA,SAAS,UAAW,MAAM,SAAS,CAAC,MAAM,MAAM,IAAI,CAAC,CAAE,CAC5D,CACF,IACA,CAAC;EAQL;CACF;AACF;AAEA,MAAa,sCAAsC,EACjD,WACA,UACA,UACA,yBAAyB,MACzB,sBAAsB,qCACtB,kBACA,mBAAmB,CAAC,GACpB,gBACA,2BAWmD;CACnD,MAAM,iBAAiB,IAAI,eAA8C;CAEzE,eAAe,IAAI,UAAU,UAAU,MAAM;CAC7C,eAAe,IAAI,aAAa,SAAS;CACzC,eAAe,IAAI,YAAY,QAAQ;CACvC,eAAe,IAAI,wBAAwB,SAAS,UAAU;CAC9D,eAAe,IAAI,sBAAsB,SAAS,QAAQ;CAC1D,MAAM,qBAAqB,wCAAwC;EACjE,SAAS;EACT,UAAU;CACZ,CAAC;CACD,IAAI,oBACF,eAAe,IAAI,sBAAsB,kBAAkB;CAE7D,IAAI,oBAAoB,iBAAiB,UAAU,SAAS,GAC1D,eAAe,IAAI,oBAAoB,gBAAgB;CAEzD,IAAI,iBAAiB,SAAS,GAC5B,eAAe,IAAI,oBAAoB,gBAAgB;CAEzD,IAAI,gBACF,eAAe,IAAI,kBAAkB,cAAc;CAErD,IAAI,sBACF,eAAe,IAAI,wBAAwB,oBAAoB;CAGjE,IAAI,CAAC,UACH,OAAO;CAGT,MAAM,gBAAgB,mCAAmC,UAAU,mBAAmB;CACtF,UAAU,WAAW,aAAa;CAClC,eAAe,IAAI,iBAAiB,aAAa;CAEjD,OAAO;AACT;;;;;;AAOA,MAAa,mCACX,mBAEA,gBAAgB,IAAI,WAAW,CAAC,EAAE,WAAW,gBAAgB,IAAI,eAAe;AAElF,MAAa,mCACX,mBACG;CACH,MAAM,SAAS,gBAAgB,IAAI,QAAQ;CAC3C,MAAM,YAAY,gBAAgB,IAAI,WAAW;CACjD,IAAI,CAAC,UAAU,CAAC,aAAa,UAAU,WAAW,QAChD,MAAM,IAAI,MAAM,+DAA+D;CAGjF,OAAO;EAAE;EAAQ;CAAU;AAC7B"}

package/dist/{request-guardrails-TmgQtqp4.mjs → request-guardrails-C0ugBOp0.mjs}

@@ -1,10 +1,10 @@
-import { t as SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES } from "./attachments-B0hg3vpT.mjs";
+import { t as SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES } from "./attachments-BuNni5vB.mjs";
 //#region src/server/request-guardrails.ts
-const SURVEY_ASSISTANT_MAX_REQUEST_BYTES = 20 * 1024 * 1024;
+const SURVEY_ASSISTANT_MAX_REQUEST_BYTES = 20971520;
 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_ATTACHMENT_BYTES = 5242880;
+const SURVEY_ASSISTANT_MAX_TOTAL_ATTACHMENT_BYTES = 12582912;
 const SURVEY_ASSISTANT_MAX_TEXT_PART_CHARS = 64e3;
 const SURVEY_ASSISTANT_MAX_ATTACHMENT_NAME_CHARS = 255;
 const SURVEY_ASSISTANT_ACCEPTED_ATTACHMENT_TYPES = new Set(SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES);
@@ -66,6 +66,7 @@ const validateSurveyAssistantMessages = (value, limits = SURVEY_ASSISTANT_DEFAUL
 	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.");
+		if (typeof message.id !== "string" || !message.id.trim() || message.id.length > 512) throw new SurveyAssistantRequestError("The survey assistant message id is invalid.");
 		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") {
@@ -119,4 +120,4 @@ const readSurveyAssistantRequestJson = async (request, maxRequestBytes = SURVEY_
 //#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-TmgQtqp4.mjs.map
+//# sourceMappingURL=request-guardrails-C0ugBOp0.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request-guardrails-C0ugBOp0.mjs","names":[],"sources":["../src/server/request-guardrails.ts"],"sourcesContent":["import type { UIMessage } from \"ai\";\nimport { SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES } from \"../protocol/attachments\";\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  SURVEY_ASSISTANT_ATTACHMENT_MEDIA_TYPES,\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/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};\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    if (typeof message.id !== \"string\" || !message.id.trim() || message.id.length > 512) {\n      throw new SurveyAssistantRequestError(\"The survey assistant message id is invalid.\");\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. Upload a PDF, PNG, or JPEG file.\",\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":";;AAGA,MAAa,qCAAqC;AAClD,MAAa,gCAAgC;AAC7C,MAAa,mCAAmC;AAChD,MAAa,wCAAwC;AACrD,MAAa,8CAA8C;AAC3D,MAAa,uCAAuC;AACpD,MAAa,6CAA6C;AAE1D,MAAa,6CAA6C,IAAI,IAC5D,uCACF;AAaA,MAAa,0CAAwE,OAAO,OAAO;CACjG,yBAAyB;CACzB,oBAAoB;CACpB,wBAAA;CACA,gBAAA;CACA,aAAA;CACA,iBAAiB;CACjB,kBAAkB;CAClB,yBAAyB;AAC3B,CAAC;AAED,IAAa,8BAAb,cAAiD,MAAM;CACrD;CAEA,YAAY,SAAiB,SAAS,KAAK;EACzC,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,SAAS;CAChB;AACF;AAEA,MAAM,uBAAuE;CAC3E,oBAAoB,UAClB,MAAM,OAAO,MAAQ,MAAM,OAAO,MAAQ,MAAM,OAAO,MAAQ,MAAM,OAAO;CAC9E,eAAe,UAAU,MAAM,OAAO,OAAQ,MAAM,OAAO,OAAQ,MAAM,OAAO;CAChF,cAAc,UACZ;EAAC;EAAM;EAAM;EAAM;EAAM;EAAM;EAAM;EAAM;CAAI,CAAC,CAAC,OAC9C,OAAO,UAAU,MAAM,WAAW,KACrC;AACJ;AAEA,MAAM,sBAAsB,YAAoB;CAC9C,IAAI;EACF,MAAM,SAAS,KAAK,QAAQ,MAAM,GAAG,EAAE,CAAC;EACxC,OAAO,WAAW,KAAK,SAAS,cAAc,UAAU,WAAW,CAAC,CAAC;CACvE,QAAQ;EACN,MAAM,IAAI,4BAA4B,+CAA+C;CACvF;AACF;AAEA,MAAM,mBAAmB,KAAa,sBAAsC;CAC1E,MAAM,QAAQ,gDAAgD,KAAK,GAAG;CACtE,IAAI,CAAC,OACH,MAAM,IAAI,4BAA4B,uCAAuC;CAE/E,IAAI,MAAM,EAAE,EAAE,YAAY,MAAM,kBAAkB,YAAY,GAC5D,MAAM,IAAI,4BAA4B,oDAAoD;CAG5F,MAAM,UAAU,MAAM,MAAM;CAC5B,MAAM,mBAAmB,qBAAqB,kBAAkB,YAAY;CAC5E,IAAI,oBAAoB,CAAC,iBAAiB,mBAAmB,OAAO,CAAC,GACnE,MAAM,IAAI,4BACR,4DACF;CAEF,MAAM,UAAU,QAAQ,SAAS,IAAI,IAAI,IAAI,QAAQ,SAAS,GAAG,IAAI,IAAI;CACzE,OAAO,KAAK,IAAI,GAAG,KAAK,MAAO,QAAQ,SAAS,IAAK,CAAC,IAAI,OAAO;AACnE;AAEA,MAAa,mCACX,OACA,SAAuC,4CACvB;CAChB,IAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAC5C,MAAM,IAAI,4BAA4B,yCAAyC;CAEjF,IAAI,MAAM,SAAS,OAAO,aACxB,MAAM,IAAI,4BACR,0DACF;CAEF,IAAI,MAAM,WAAW,KAAK,MAAM,EAAE,EAAE,SAAS,QAC3C,MAAM,IAAI,4BACR,0EACF;CAGF,IAAI,kBAAkB;CACtB,IAAI,uBAAuB;CAC3B,KAAK,MAAM,WAAW,OAAO;EAC3B,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,CAAC,MAAM,QAAQ,QAAQ,KAAK,GACzE,MAAM,IAAI,4BAA4B,8CAA8C;EAEtF,IAAI,OAAO,QAAQ,OAAO,YAAY,CAAC,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG,SAAS,KAC9E,MAAM,IAAI,4BAA4B,6CAA6C;EAGrF,KAAK,MAAM,QAAQ,QAAQ,OAAO;GAChC,IAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,OAAO,KAAK,SAAS,UAC5D,MAAM,IAAI,4BAA4B,+CAA+C;GAEvF,IAAI,KAAK,SAAS,QAAQ;IACxB,IAAI,OAAO,KAAK,SAAS,UACvB,MAAM,IAAI,4BAA4B,4CAA4C;IAEpF,IAAI,KAAK,KAAK,SAAS,OAAO,kBAC5B,MAAM,IAAI,4BAA4B,yCAAyC;IAEjF;GACF;GACA,IAAI,KAAK,SAAS,QAChB,MAAM,IAAI,4BACR,qDACF;GAGF,mBAAmB;GACnB,IAAI,kBAAkB,OAAO,gBAC3B,MAAM,IAAI,4BACR,wDACF;GAEF,IACE,OAAO,KAAK,cAAc,YAC1B,CAAC,OAAO,wBAAwB,IAAI,KAAK,UAAU,YAAY,CAAC,GAEhE,MAAM,IAAI,4BACR,yFACF;GAEF,IAAI,OAAO,KAAK,QAAQ,UACtB,MAAM,IAAI,4BAA4B,+CAA+C;GAEvF,IACE,KAAK,aAAa,KAAA,MACjB,OAAO,KAAK,aAAa,YACxB,KAAK,SAAS,SAAS,OAAO,0BAC9B,wBAAwB,KAAK,KAAK,QAAQ,IAE5C,MAAM,IAAI,4BAA4B,kDAAkD;GAG1F,MAAM,QAAQ,gBAAgB,KAAK,KAAK,KAAK,SAAS;GACtD,IAAI,QAAQ,OAAO,oBACjB,MAAM,IAAI,4BAA4B,6CAA6C;GAErF,wBAAwB;GACxB,IAAI,uBAAuB,OAAO,yBAChC,MAAM,IAAI,4BACR,0DACF;EAEJ;CACF;CAEA,OAAO;AACT;AAEA,MAAa,iCAAiC,OAC5C,SACA,kBAAkB,uCACG;CACrB,MAAM,iBAAiB,OAAO,QAAQ,QAAQ,IAAI,gBAAgB,CAAC;CACnE,IAAI,OAAO,SAAS,cAAc,KAAK,iBAAiB,iBACtD,MAAM,IAAI,4BAA4B,8CAA8C,GAAG;CAGzF,MAAM,SAAS,QAAQ,MAAM,UAAU;CACvC,MAAM,SAAuB,CAAC;CAC9B,IAAI,aAAa;CACjB,IAAI,QACF,OAAO,MAAM;EACX,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;EAC1C,IAAI,MAAM;EACV,cAAc,MAAM;EACpB,IAAI,aAAa,iBAAiB;GAChC,MAAM,OAAO,OAAO;GACpB,MAAM,IAAI,4BAA4B,8CAA8C,GAAG;EACzF;EACA,OAAO,KAAK,KAAK;CACnB;CAEF,MAAM,QAAQ,IAAI,WAAW,UAAU;CACvC,IAAI,SAAS;CACb,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,IAAI,OAAO,MAAM;EACvB,UAAU,MAAM;CAClB;CACA,MAAM,OAAO,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK;CAE3C,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,QAAQ;EACN,MAAM,IAAI,4BAA4B,iDAAiD;CACzF;AACF"}

package/dist/server-agent.d.mts

@@ -1,48 +1,48 @@
-import { g as SurveyChangeSetShape } from "./lifecycle-Bx0aq_4S.mjs";
-import { o as SurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID } from "./constants-Be91Gay9.mjs";
-import { n as surveyAssistantTools } from "./index-x0qprHgK.mjs";
-import * as _$_mastra_core_agent0 from "@mastra/core/agent";
+import { g as SurveyChangeSetShape } from "./lifecycle-DFzxVxpq.mjs";
+import { o as SurveyAssistantRequestContext, t as SURVEY_ASSISTANT_AGENT_ID } from "./constants-HL_klgJl.mjs";
+import { n as surveyAssistantTools } from "./index-CeUlGkoU.mjs";
 import { Agent, AgentConfig } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
-import * as _$_mastra_core_tools0 from "@mastra/core/tools";
 import { InputProcessor } from "@mastra/core/processors";
-
 //#region src/server/agent.d.ts
-declare const surveyAssistantThreadAttachmentProcessor: InputProcessor;
+export declare const surveyAssistantThreadAttachmentProcessor: InputProcessor;
 type SurveyAssistantAgentConfig = AgentConfig<typeof SURVEY_ASSISTANT_AGENT_ID, typeof surveyAssistantTools, undefined, SurveyAssistantRequestContext>;
 type SurveyAssistantMemoryOptions = NonNullable<NonNullable<ConstructorParameters<typeof Memory>[0]>["options"]>;
-type SurveyAssistantObservationalMemoryOptions = Exclude<SurveyAssistantMemoryOptions["observationalMemory"], boolean | undefined>;
+export type SurveyAssistantObservationalMemoryOptions = Exclude<SurveyAssistantMemoryOptions["observationalMemory"], boolean | undefined>;
 type SurveyAssistantObservationalMemoryOptionsInput = Partial<Omit<SurveyAssistantObservationalMemoryOptions, "model">> & {
   model: NonNullable<SurveyAssistantObservationalMemoryOptions["model"]>;
 };
-declare const SURVEY_ASSISTANT_OBSERVATIONAL_MEMORY_DEFAULTS: {
+export declare const SURVEY_ASSISTANT_OBSERVATIONAL_MEMORY_DEFAULTS: {
   readonly messageTokens: 48000;
   readonly observationTokens: 80000;
   readonly previousObserverTokens: 24000;
 };
-declare const createSurveyAssistantObservationalMemoryOptions: ({
-  model,
-  observation,
-  reflection,
-  ...overrides
-}: SurveyAssistantObservationalMemoryOptionsInput) => SurveyAssistantObservationalMemoryOptions;
-interface CreateSurveyAssistantAgentOptions {
+export declare const createSurveyAssistantObservationalMemoryOptions: ({ model, observation, reflection, ...overrides }: SurveyAssistantObservationalMemoryOptionsInput) => SurveyAssistantObservationalMemoryOptions;
+export interface CreateSurveyAssistantAgentOptions {
   model: SurveyAssistantAgentConfig["model"];
   memory?: SurveyAssistantAgentConfig["memory"];
   observationalMemory?: SurveyAssistantObservationalMemoryOptions | false;
 }
-declare const createSurveyAssistantAgent: ({
-  memory,
-  model,
-  observationalMemory
-}: CreateSurveyAssistantAgentOptions) => Agent<"survey-assistant-agent", Readonly<{
-  survey_inspect: _$_mastra_core_tools0.Tool<{
-    action: "current-context" | "search-items" | "item-details" | "localization" | "assets" | "expression-diagnostics" | "raw-json";
+export declare const createSurveyAssistantAgent: ({ memory, model, observationalMemory }: CreateSurveyAssistantAgentOptions) => Agent<"survey-assistant-agent", Readonly<{
+  survey_inspect: import("@mastra/core/tools").Tool<{
+    action: "localization" | "current-context" | "search-items" | "item-details" | "assets" | "expression-diagnostics" | "raw-json";
     reason?: string | undefined;
     scopes?: ("summary" | "selected-item" | "outline" | "response-slots" | "ui-context" | "history")[] | undefined;
     query?: string | undefined;
+    itemTypes?: ("content" | "group" | "page-break")[] | undefined;
+    elementTypes?: string[] | undefined;
+    locales?: string[] | undefined;
     sourceLocale?: string | undefined;
     targetLocale?: string | undefined;
+    localizationRefs?: ({
+      scope: "content";
+      ownerId: string;
+      role: string;
+    } | {
+      scope: "survey";
+      surface: "surveyCardContent" | "navigationContent" | "validationMessages";
+      contentKey: string;
+    })[] | undefined;
     missingOnly?: boolean | undefined;
     itemRef?: string | undefined;
     cursor?: string | undefined;
@@ -54,19 +54,19 @@ declare const createSurveyAssistantAgent: ({
     limit?: number | undefined;
   }, {
     ok: boolean;
-    action: "current-context" | "search-items" | "item-details" | "localization" | "assets" | "expression-diagnostics" | "raw-json";
+    action: "localization" | "current-context" | "search-items" | "item-details" | "assets" | "expression-diagnostics" | "raw-json";
     modelSummary: string;
     reason?: string | undefined;
     result?: unknown;
-  }, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_inspect", unknown>;
-  survey_change: _$_mastra_core_tools0.Tool<{
+  }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_inspect", unknown>;
+  survey_change: import("@mastra/core/tools").Tool<{
     summary: string;
     operations: unknown[];
     retryOfChangeIds?: string[] | undefined;
-  }, SurveyChangeSetShape, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_change", unknown>;
-  survey_authoring_reference: _$_mastra_core_tools0.Tool<{
+  }, SurveyChangeSetShape, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_change", unknown>;
+  survey_authoring_reference: import("@mastra/core/tools").Tool<{
     topic: string;
-    itemType?: string | undefined;
+    elementType?: string | undefined;
     operationKind?: string | undefined;
     detail?: "full" | "compact" | undefined;
     reason?: string | undefined;
@@ -75,11 +75,11 @@ declare const createSurveyAssistantAgent: ({
     topic: string;
     title: string;
     content: string;
-    itemType?: string | undefined;
+    elementType?: 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<{
+  }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_authoring_reference", unknown>;
+  survey_expression: import("@mastra/core/tools").Tool<{
     action: "context" | "prepare";
     retryOfChangeIds?: string[] | undefined;
     reason?: string | undefined;
@@ -95,23 +95,37 @@ declare const createSurveyAssistantAgent: ({
     modelSummary: string;
     listOrdering: Record<string, string>;
     responseSlots: {
-      ref: string;
+      ref: {
+        slotId: string;
+        method: "get" | "isDefined";
+      };
       valueType?: string | undefined;
+      variableName?: string | undefined;
+      itemId?: string | undefined;
     }[];
     nextCursor?: string | undefined;
     totalResponseSlots?: number | undefined;
     surveyResponseSlotCount?: number | undefined;
     totalExpressionLocations?: number | undefined;
+    totalStateTargets?: number | undefined;
+    stateTargets?: {
+      targetRef: {
+        ownerId: string;
+      };
+      state: "disabled";
+      itemId: string;
+      kind: string;
+    }[] | undefined;
     unresolvedItemIds?: string[] | undefined;
     expressionLocations?: {
       itemId: string;
-      key: string;
+      editorName: string;
       itemType: string;
       rawIndex: number;
       locations: string[];
     }[] | undefined;
-  }, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_expression", unknown>;
-  survey_attachment: _$_mastra_core_tools0.Tool<{
+  }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_expression", unknown>;
+  survey_attachment: import("@mastra/core/tools").Tool<{
     documentIds?: string[] | undefined;
     documentRequests?: {
       documentId: string;
@@ -132,9 +146,15 @@ declare const createSurveyAssistantAgent: ({
       } | undefined;
       focus?: string | undefined;
     }[];
+    unavailable?: {
+      id: string;
+      reason: "not-listed" | "content-unavailable" | "attachment-limit";
+      filename?: string | undefined;
+      mediaType?: string | undefined;
+    }[] | undefined;
     warnings?: string[] | undefined;
-  }, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_attachment", unknown>;
-  survey_audit: _$_mastra_core_tools0.Tool<{
+  }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_attachment", unknown>;
+  survey_audit: import("@mastra/core/tools").Tool<{
     sourceLocale?: string | undefined;
     targetLocales?: string[] | undefined;
     maxFindings?: number | undefined;
@@ -145,8 +165,8 @@ declare const createSurveyAssistantAgent: ({
     ok: boolean;
     reason?: string | undefined;
     report?: unknown;
-  }, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_audit", unknown>;
-  survey_asset: _$_mastra_core_tools0.Tool<{
+  }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_audit", unknown>;
+  survey_asset: import("@mastra/core/tools").Tool<{
     action: "import-attachment" | "update-metadata" | "remove";
     summary: string;
     retryOfChangeIds?: string[] | undefined;
@@ -155,8 +175,7 @@ declare const createSurveyAssistantAgent: ({
     name?: string | null | undefined;
     filename?: string | null | undefined;
     alt?: string | null | undefined;
-  }, SurveyChangeSetShape, unknown, unknown, _$_mastra_core_tools0.ToolExecutionContext<unknown, unknown, unknown>, "survey_asset", unknown>;
-}>, undefined, SurveyAssistantRequestContext, _$_mastra_core_agent0.AgentEditorConfig | undefined>;
+  }, SurveyChangeSetShape, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "survey_asset", unknown>;
+}>, undefined, SurveyAssistantRequestContext, import("@mastra/core/agent").AgentEditorConfig | undefined>;
 //#endregion
-export { CreateSurveyAssistantAgentOptions, SURVEY_ASSISTANT_OBSERVATIONAL_MEMORY_DEFAULTS, SurveyAssistantObservationalMemoryOptions, createSurveyAssistantAgent, createSurveyAssistantObservationalMemoryOptions, surveyAssistantThreadAttachmentProcessor };
 //# sourceMappingURL=server-agent.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server-agent.d.mts","names":[],"sources":["../src/server/agent.ts"],"mappings":";;;;;;;;;;cAyBa,wCAAA,EAA0C,cAAA;AAAA,KA0SlD,0BAAA,GAA6B,WAAA,QACzB,yBAAA,SACA,oBAAA,aAEP,6BAAA;AAAA,KAGG,4BAAA,GAA+B,WAAA,CAClC,WAAA,CAAY,qBAAA,QAA6B,MAAA;AAAA,KA8E/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":";;;;;;;qBAyBa,0CAA0C;KA8VlD,6BAA6B,mBACzB,kCACA,iCAEP;KAGG,+BAA+B,YAClC,YAAY,6BAA6B;YA8E/B,4CAA4C,QACtD;KAIG,iDAAiD,QACpD,KAAK;EAEL,OAAO,YAAY;;qBAGR;;;;;qBAMA,oDAAmD,OAAA,aAAA,eAAA,aAK7D,mDAAiD;iBAkCnC;EACf,OAAO;EACP,SAAS;EACT,sBAAsB;;qBAGX,+BAA8B,QAAA,OAAA,uBAIxC,sCAAiC,gCAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA2BC,4DAAA"}