@case-framework/survey-assistant 0.1.0 → 0.1.1

package/README.md

@@ -24,6 +24,8 @@ import {
 
 import {
   createSurveyAssistantChatHandler,
+  createSurveyAssistantSurveyLifecycle,
+  createSurveyAssistantSurveyThreadMetadata,
   type SurveyAssistantAuthorize,
 } from "@case-framework/survey-assistant/server";
 
@@ -57,6 +59,7 @@ import {
   createSurveyAssistantControllerBridge,
   createSurveyAssistantTaskClient,
   createSurveyAssistantTaskExecutor,
+  createSurveyAssistantThreadLauncher,
 } from "@case-framework/survey-assistant/react/integration";
 
 import { useSurveyAssistantModelCatalog } from "@case-framework/survey-assistant/react";
@@ -83,8 +86,9 @@ instructions, thread-scoped Observational Memory defaults, and optional
 history-compatibility policy for custom memory setups. `/server/runtime` is the
 high-level composition layer: it parses an injected environment, resolves the
 approved provider/model catalog (including optional Azure deployment
-discovery), exposes standard Mastra agents and gateways, and creates the Web
-handlers. The host still constructs the standard Mastra instance and owns
+discovery), applies independent same-provider task and memory model policy,
+exposes standard Mastra agents and gateways, and creates the Web handlers. The
+host still constructs the standard Mastra instance and owns
 credentials, authorization, storage connection lifecycle, logging, and route
 files.
 
@@ -109,17 +113,74 @@ defaults without supplying a complete catalog.
   localizations={assistantLocalizations}
   onModelChange={setSelectedModelId}
   resourceId={authenticatedUserId}
+  surveyId={surveyId}
   threadApi="/api/survey-assistant/threads"
 />
 ```
 
+Host UI can start a fresh assistant thread with an already-submitted prompt. The
+launcher queues requests made before the panel mounts, which supports replacing
+a prompt-only new-survey screen with the chat after submission:
+
+```tsx
+const threadLauncher = useMemo(() => createSurveyAssistantThreadLauncher(), []);
+
+const describeNewItem = (prompt: string, parentItemId: string, afterItemId?: string) => {
+  setAssistantOpen(true);
+  void threadLauncher.startThread({
+    prompt,
+    uiContext: {
+      activeSurface: "new-item",
+      focusItemId: parentItemId,
+      highlights: [
+        {
+          kind: "insertion-target",
+          itemId: parentItemId,
+          label: "Requested item position",
+          details: afterItemId ? `Insert after item ${afterItemId}` : "Insert as the first child",
+        },
+      ],
+    },
+  });
+};
+
+return assistantOpen ? (
+  <ConnectedSurveyAssistantPanel
+    api="/api/survey-assistant/chat"
+    applyPolicy="auto"
+    controller={assistantController}
+    resourceId={authenticatedUserId}
+    threadApi="/api/survey-assistant/threads"
+    threadLauncher={threadLauncher}
+  />
+) : (
+  <NewSurveyPrompt onSubmit={(prompt) => describeNewItem(prompt, "root")} />
+);
+```
+
+`startThread()` resolves after the new thread has been selected and its first
+turn has been accepted by the chat session. `uiContext` is layered over the
+controller snapshot for that turn only; it does not mutate editor selection or
+navigation state. Use typed highlights for transient targets such as an
+insertion position.
+
 The browser-supplied `resourceId` is request metadata, not authorization. A
 production host must derive user, survey, and thread ownership in the server
 handler's required `authorize` callback.
 
+For the supported real-app setup, configuration reference, route/auth contract,
+attachment policy, apply settlement, observability, cleanup, and acceptance
+checklist, see [Real-host integration](./docs/integration.md).
+
+`createSurveyAssistantSurveyLifecycle(...).forSurvey(surveyId, resourceId)`
+provides one shared thread identity, chat authorizer, panel-prop object, and
+per-user cleanup method so those paths cannot drift onto different survey
+metadata.
+
 `/protocol`, `/engine`, and `/capabilities/default` may not import React,
-Next.js, Mastra, AI SDK, `survey-ui`, or Node-only storage. `/protocol` has only
-Zod runtime dependencies; `/engine` may use `survey-core`. `/server` is
+Next.js, Mastra, AI SDK, `survey-ui`, or Node-only storage. `/protocol` has Zod
+plus the narrow browser-safe `survey-core/editor/colors` runtime dependency;
+`/engine` may use the full `survey-core` API. `/server` is
 server-only and may import Mastra, AI SDK, and Node APIs, but never React,
 Next.js, or `survey-ui`. The separate server entries prevent handler-only
 consumers from eagerly loading Agent/Memory code. `@case-framework/survey-ui`
@@ -181,15 +242,14 @@ once. Server configuration imports `ratingAssistantCapability` directly and
 adds it to the trusted capability set; it must not trust capability functions
 received from a browser snapshot.
 
-See [Custom item registration](../../docs/survey-assistant/survey-ui-bridge.md#custom-item-registration)
-for the complete editor and server composition example.
-
 ```bash
 pnpm --filter @case-framework/survey-assistant check
+pnpm --filter @case-framework/survey-assistant check:release
 ```
 
-This typechecks and builds all entries, copies server references, then verifies
-their source and built import graphs. The optional Postgres entry accepts a
+`check` typechecks and builds all entries, copies server references, verifies
+their source and built import graphs, and runs unit tests. `check:release` also
+builds the clean Next host fixture. The optional Postgres entry accepts a
 host-owned `PostgresStore` or store configuration; it does not read environment
 variables, create hidden singletons, or own connection shutdown.
 

package/dist/{authoring-references-X6uRaWuf.mjs → authoring-references-DYuOAdVx.mjs}

@@ -20,6 +20,21 @@ const surveyAuthoringReferenceTopics = [
 	"assistant-operations",
 	"survey-quality"
 ];
+const ITEM_TYPE_SECTION_HEADINGS = {
+	group: "group",
+	"page-break": "page-break",
+	infoItem: "infoItem",
+	choiceItem: "choiceItem",
+	formItem: "formItem"
+};
+const extractLevelTwoSection = (markdown, heading) => {
+	const lines = markdown.split("\n");
+	const sectionStart = lines.findIndex((line) => line.trim() === `## ${heading}`);
+	if (sectionStart < 0) return;
+	const nextSectionOffset = lines.slice(sectionStart + 1).findIndex((line) => line.startsWith("## "));
+	const sectionEnd = nextSectionOffset < 0 ? lines.length : sectionStart + 1 + nextSectionOffset;
+	return lines.slice(sectionStart, sectionEnd).join("\n").trim();
+};
 const surveyAuthoringReferences = {
 	"core-rules": {
 		title: "Core authoring rules",
@@ -62,7 +77,16 @@ const surveyAuthoringReferences = {
 		content: loadReference("survey-quality.md")
 	}
 };
+const getBuiltInItemTypeAuthoringReference = (itemType) => {
+	const heading = ITEM_TYPE_SECTION_HEADINGS[itemType];
+	if (!heading) return;
+	const content = extractLevelTwoSection(surveyAuthoringReferences["item-types"].content, heading);
+	return content ? {
+		title: `${heading} item type`,
+		content
+	} : void 0;
+};
 //#endregion
-export { surveyAuthoringReferences as n, surveyAuthoringReferenceTopics as t };
+export { surveyAuthoringReferenceTopics as n, surveyAuthoringReferences as r, getBuiltInItemTypeAuthoringReference as t };
 
-//# sourceMappingURL=authoring-references-X6uRaWuf.mjs.map
+//# sourceMappingURL=authoring-references-DYuOAdVx.mjs.map

package/dist/authoring-references-DYuOAdVx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring-references-DYuOAdVx.mjs","names":[],"sources":["../../../node_modules/.pnpm/tsdown@0.21.10_synckit@0.11.12_typescript@6.0.3/node_modules/tsdown/esm-shims.js","../src/server/authoring-references.ts"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n","import { readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nconst loadReference = (fileName: string) =>\n  readFileSync(resolve(__dirname, \"references\", fileName), \"utf8\").trim();\n\nexport const surveyAuthoringReferenceTopics = [\n  \"core-rules\",\n  \"survey-data-model\",\n  \"source-material-surveys\",\n  \"localization\",\n  \"rich-text-content\",\n  \"item-types\",\n  \"embedded-forms\",\n  \"expressions\",\n  \"assistant-operations\",\n  \"survey-quality\",\n] as const;\n\nexport type SurveyAuthoringReferenceTopic = (typeof surveyAuthoringReferenceTopics)[number];\n\nconst ITEM_TYPE_SECTION_HEADINGS: Readonly<Record<string, string>> = {\n  group: \"group\",\n  \"page-break\": \"page-break\",\n  infoItem: \"infoItem\",\n  choiceItem: \"choiceItem\",\n  formItem: \"formItem\",\n};\n\nconst extractLevelTwoSection = (markdown: string, heading: string): string | undefined => {\n  const lines = markdown.split(\"\\n\");\n  const sectionStart = lines.findIndex((line) => line.trim() === `## ${heading}`);\n  if (sectionStart < 0) {\n    return undefined;\n  }\n\n  const nextSectionOffset = lines\n    .slice(sectionStart + 1)\n    .findIndex((line) => line.startsWith(\"## \"));\n  const sectionEnd = nextSectionOffset < 0 ? lines.length : sectionStart + 1 + nextSectionOffset;\n\n  return lines.slice(sectionStart, sectionEnd).join(\"\\n\").trim();\n};\n\nexport const surveyAuthoringReferences = {\n  \"core-rules\": {\n    title: \"Core authoring rules\",\n    content: loadReference(\"core-rules.md\"),\n  },\n  \"survey-data-model\": {\n    title: \"Survey data model\",\n    content: loadReference(\"survey-data-model.md\"),\n  },\n  \"source-material-surveys\": {\n    title: \"Source-material survey implementation\",\n    content: loadReference(\"source-material-surveys.md\"),\n  },\n  localization: {\n    title: \"Survey localization\",\n    content: loadReference(\"localization.md\"),\n  },\n  \"rich-text-content\": {\n    title: \"Rich text content\",\n    content: loadReference(\"rich-text-content.md\"),\n  },\n  \"item-types\": {\n    title: \"Item types\",\n    content: loadReference(\"item-types.md\"),\n  },\n  \"embedded-forms\": {\n    title: \"Choice option embedded forms\",\n    content: loadReference(\"embedded-forms.md\"),\n  },\n  expressions: {\n    title: \"Expressions\",\n    content: loadReference(\"expressions.md\"),\n  },\n  \"assistant-operations\": {\n    title: \"Assistant operations\",\n    content: loadReference(\"assistant-operations.md\"),\n  },\n  \"survey-quality\": {\n    title: \"Survey quality review\",\n    content: loadReference(\"survey-quality.md\"),\n  },\n} as const satisfies Record<SurveyAuthoringReferenceTopic, { title: string; content: string }>;\n\nexport const getBuiltInItemTypeAuthoringReference = (\n  itemType: string,\n): { title: string; content: string } | undefined => {\n  const heading = ITEM_TYPE_SECTION_HEADINGS[itemType];\n  if (!heading) {\n    return undefined;\n  }\n\n  const content = extractLevelTwoSection(surveyAuthoringReferences[\"item-types\"].content, heading);\n  return content ? { title: `${heading} item type`, content } : undefined;\n};\n"],"x_google_ignoreList":[0],"mappings":";;;;AAIA,MAAM,oBAAoB,cAAc,OAAO,KAAK,IAAI;AACxD,MAAM,mBAAmB,KAAK,QAAQ,aAAa,CAAC;AAEpD,MAAa,YAA4B,4BAAY;;;ACJrD,MAAM,iBAAiB,aACrB,aAAa,QAAQ,WAAW,cAAc,SAAS,EAAE,OAAO,CAAC,MAAM;AAEzE,MAAa,iCAAiC;CAC5C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAID,MAAM,6BAA+D;CACnE,OAAO;CACP,cAAc;CACd,UAAU;CACV,YAAY;CACZ,UAAU;CACX;AAED,MAAM,0BAA0B,UAAkB,YAAwC;CACxF,MAAM,QAAQ,SAAS,MAAM,KAAK;CAClC,MAAM,eAAe,MAAM,WAAW,SAAS,KAAK,MAAM,KAAK,MAAM,UAAU;AAC/E,KAAI,eAAe,EACjB;CAGF,MAAM,oBAAoB,MACvB,MAAM,eAAe,EAAE,CACvB,WAAW,SAAS,KAAK,WAAW,MAAM,CAAC;CAC9C,MAAM,aAAa,oBAAoB,IAAI,MAAM,SAAS,eAAe,IAAI;AAE7E,QAAO,MAAM,MAAM,cAAc,WAAW,CAAC,KAAK,KAAK,CAAC,MAAM;;AAGhE,MAAa,4BAA4B;CACvC,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,gBAAgB;EACxC;CACD,qBAAqB;EACnB,OAAO;EACP,SAAS,cAAc,uBAAuB;EAC/C;CACD,2BAA2B;EACzB,OAAO;EACP,SAAS,cAAc,6BAA6B;EACrD;CACD,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,kBAAkB;EAC1C;CACD,qBAAqB;EACnB,OAAO;EACP,SAAS,cAAc,uBAAuB;EAC/C;CACD,cAAc;EACZ,OAAO;EACP,SAAS,cAAc,gBAAgB;EACxC;CACD,kBAAkB;EAChB,OAAO;EACP,SAAS,cAAc,oBAAoB;EAC5C;CACD,aAAa;EACX,OAAO;EACP,SAAS,cAAc,iBAAiB;EACzC;CACD,wBAAwB;EACtB,OAAO;EACP,SAAS,cAAc,0BAA0B;EAClD;CACD,kBAAkB;EAChB,OAAO;EACP,SAAS,cAAc,oBAAoB;EAC5C;CACF;AAED,MAAa,wCACX,aACmD;CACnD,MAAM,UAAU,2BAA2B;AAC3C,KAAI,CAAC,QACH;CAGF,MAAM,UAAU,uBAAuB,0BAA0B,cAAc,SAAS,QAAQ;AAChG,QAAO,UAAU;EAAE,OAAO,GAAG,QAAQ;EAAa;EAAS,GAAG,KAAA"}

package/dist/{capabilities-B6tvE7fK.mjs → capabilities-DZ0a_o2y.mjs}

@@ -1,4 +1,4 @@
-import { W as assistantItemTypeManifestSchema } from "./protocol-DV0ka9WT.mjs";
+import { G as assistantItemTypeManifestSchema } from "./protocol-7EEgcYja.mjs";
 import { buildCapabilityDigest } from "./digest.mjs";
 //#region src/engine/capabilities.ts
 const resolveAssistantCapabilityReference = ({ capabilities, itemType, topic }) => capabilities?.byItemType.get(itemType)?.references?.find((reference) => reference.topic === topic);
@@ -63,4 +63,4 @@ const assertSurveyAssistantCapabilities = ({ manifest, trustedCapabilities, vers
 //#endregion
 export { getDeterministicCreateItemTypes as a, resolveAssistantItemCreation as c, createUnsupportedItemCapability as i, assertSurveyAssistantCapabilities as n, inspectAssistantItem as o, createSurveyAssistantCapabilities as r, resolveAssistantCapabilityReference as s, SurveyAssistantCapabilityMismatchError as t };
 
-//# sourceMappingURL=capabilities-B6tvE7fK.mjs.map
+//# sourceMappingURL=capabilities-DZ0a_o2y.mjs.map

package/dist/{capabilities-B6tvE7fK.mjs.map → capabilities-DZ0a_o2y.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"capabilities-B6tvE7fK.mjs","names":[],"sources":["../src/engine/capabilities.ts"],"sourcesContent":["import type { RawSurveyItem, ValueType } from \"@case-framework/survey-core\";\nimport type {\n  AssistantItemTypeManifest,\n  JsonValue,\n  SurveyAssistantCapabilityManifest,\n  SurveyOperation,\n  SurveyValidationIssue,\n} from \"../protocol\";\nimport { assistantItemTypeManifestSchema } from \"../protocol\";\nimport { buildCapabilityDigest } from \"../protocol/digest\";\n\nexport interface AssistantCapabilityReference {\n  topic: string;\n  title?: string;\n  markdown: string;\n}\n\nexport interface AssistantItemInspection {\n  summary: string;\n  details?: JsonValue;\n}\n\nexport interface AssistantItemCapabilityAdapter {\n  manifest: AssistantItemTypeManifest;\n  references?: AssistantCapabilityReference[];\n  normalizeCreate?: (item: RawSurveyItem) => RawSurveyItem;\n  validateItem?: (item: RawSurveyItem) => SurveyValidationIssue[];\n  supportsOperation?: (operation: SurveyOperation) => boolean;\n  deriveResponseSlots?: (item: RawSurveyItem) => Record<string, ValueType>;\n  inspectItem?: (item: RawSurveyItem) => AssistantItemInspection;\n}\n\nexport interface SurveyAssistantCapabilitySet {\n  manifest: SurveyAssistantCapabilityManifest;\n  byItemType: ReadonlyMap<string, AssistantItemCapabilityAdapter>;\n}\n\nexport const resolveAssistantCapabilityReference = ({\n  capabilities,\n  itemType,\n  topic,\n}: {\n  capabilities: SurveyAssistantCapabilitySet | undefined;\n  itemType: string;\n  topic: string;\n}): AssistantCapabilityReference | undefined =>\n  capabilities?.byItemType\n    .get(itemType)\n    ?.references?.find((reference) => reference.topic === topic);\n\nexport const inspectAssistantItem = ({\n  capabilities,\n  item,\n}: {\n  capabilities: SurveyAssistantCapabilitySet | undefined;\n  item: RawSurveyItem;\n}): AssistantItemInspection | undefined =>\n  capabilities?.byItemType.get(item.itemType)?.inspectItem?.(item);\n\nexport type AssistantItemCreationResolution =\n  | { kind: \"deterministic\" }\n  | {\n      kind: \"ui-intent\";\n      intent: { kind: \"open-create-item\"; itemType: string; parentItemId?: string };\n    }\n  | { kind: \"unsupported\"; reason: string };\n\nexport const createSurveyAssistantCapabilities = (\n  capabilities: readonly AssistantItemCapabilityAdapter[],\n): SurveyAssistantCapabilitySet => {\n  const byItemType = new Map<string, AssistantItemCapabilityAdapter>();\n\n  for (const capability of capabilities) {\n    const manifest = assistantItemTypeManifestSchema.parse(capability.manifest);\n    const itemType = manifest.itemType;\n    if (byItemType.has(itemType)) {\n      throw new Error(`Duplicate survey assistant capability for item type \"${itemType}\".`);\n    }\n    if (\n      manifest.create === \"deterministic\" &&\n      !manifest.supportedOperations.includes(\"create-item\")\n    ) {\n      throw new Error(\n        `Deterministically creatable item type \"${itemType}\" must support \"create-item\".`,\n      );\n    }\n    const declaredReferenceTopics = new Set(manifest.referenceTopics ?? []);\n    for (const reference of capability.references ?? []) {\n      if (!declaredReferenceTopics.has(reference.topic)) {\n        throw new Error(\n          `Capability reference \"${reference.topic}\" for item type \"${itemType}\" is missing from manifest.referenceTopics.`,\n        );\n      }\n    }\n    byItemType.set(itemType, capability);\n  }\n\n  const itemTypes = Array.from(byItemType.values())\n    .map((capability) => capability.manifest)\n    .sort((left, right) => left.itemType.localeCompare(right.itemType));\n  const manifestWithoutDigest = { itemTypes };\n\n  return {\n    manifest: {\n      ...manifestWithoutDigest,\n      digest: buildCapabilityDigest(manifestWithoutDigest),\n    },\n    byItemType,\n  };\n};\n\nexport const getDeterministicCreateItemTypes = (\n  manifest: SurveyAssistantCapabilityManifest,\n): string[] =>\n  manifest.itemTypes\n    .filter((entry) => entry.create === \"deterministic\")\n    .map((entry) => entry.itemType);\n\nexport const resolveAssistantItemCreation = ({\n  itemType,\n  manifest,\n  parentItemId,\n}: {\n  itemType: string;\n  manifest: SurveyAssistantCapabilityManifest;\n  parentItemId?: string;\n}): AssistantItemCreationResolution => {\n  const capability = manifest.itemTypes.find((entry) => entry.itemType === itemType);\n  if (capability?.create === \"deterministic\") {\n    return { kind: \"deterministic\" };\n  }\n  if (capability?.create === \"interactive-only\") {\n    return {\n      kind: \"ui-intent\",\n      intent: { kind: \"open-create-item\", itemType, parentItemId },\n    };\n  }\n  return {\n    kind: \"unsupported\",\n    reason: capability\n      ? `Item type \"${itemType}\" does not support assistant creation.`\n      : `Item type \"${itemType}\" is not installed.`,\n  };\n};\n\nexport const createUnsupportedItemCapability = ({\n  displayName,\n  itemType,\n}: {\n  displayName: string;\n  itemType: string;\n}): AssistantItemCapabilityAdapter => ({\n  manifest: {\n    itemType,\n    capabilityVersion: \"unsupported-v1\",\n    displayName,\n    create: \"unsupported\",\n    supportedOperations: [],\n    contentSurfaces: [],\n  },\n});\n\nexport class SurveyAssistantCapabilityMismatchError extends Error {\n  readonly code = \"survey-assistant-capability-mismatch\";\n\n  constructor(message = \"Survey assistant capabilities changed; start a fresh turn and retry.\") {\n    super(message);\n    this.name = \"SurveyAssistantCapabilityMismatchError\";\n  }\n}\n\nexport const assertSurveyAssistantCapabilities = ({\n  manifest,\n  trustedCapabilities,\n  versionDigest,\n}: {\n  manifest: SurveyAssistantCapabilityManifest;\n  trustedCapabilities?: SurveyAssistantCapabilitySet;\n  versionDigest: string;\n}): void => {\n  const { digest: claimedDigest, ...manifestWithoutDigest } = manifest;\n  const computedDigest = buildCapabilityDigest(manifestWithoutDigest);\n  if (claimedDigest !== computedDigest || versionDigest !== claimedDigest) {\n    throw new SurveyAssistantCapabilityMismatchError();\n  }\n\n  if (trustedCapabilities && trustedCapabilities.manifest.digest !== claimedDigest) {\n    throw new SurveyAssistantCapabilityMismatchError(\n      \"The editor and server use different survey assistant capabilities; refresh and retry.\",\n    );\n  }\n};\n"],"mappings":";;;AAqCA,MAAa,uCAAuC,EAClD,cACA,UACA,YAMA,cAAc,WACX,IAAI,SAAS,EACZ,YAAY,MAAM,cAAc,UAAU,UAAU,MAAM;AAEhE,MAAa,wBAAwB,EACnC,cACA,WAKA,cAAc,WAAW,IAAI,KAAK,SAAS,EAAE,cAAc,KAAK;AAUlE,MAAa,qCACX,iBACiC;CACjC,MAAM,6BAAa,IAAI,KAA6C;AAEpE,MAAK,MAAM,cAAc,cAAc;EACrC,MAAM,WAAW,gCAAgC,MAAM,WAAW,SAAS;EAC3E,MAAM,WAAW,SAAS;AAC1B,MAAI,WAAW,IAAI,SAAS,CAC1B,OAAM,IAAI,MAAM,wDAAwD,SAAS,IAAI;AAEvF,MACE,SAAS,WAAW,mBACpB,CAAC,SAAS,oBAAoB,SAAS,cAAc,CAErD,OAAM,IAAI,MACR,0CAA0C,SAAS,+BACpD;EAEH,MAAM,0BAA0B,IAAI,IAAI,SAAS,mBAAmB,EAAE,CAAC;AACvE,OAAK,MAAM,aAAa,WAAW,cAAc,EAAE,CACjD,KAAI,CAAC,wBAAwB,IAAI,UAAU,MAAM,CAC/C,OAAM,IAAI,MACR,yBAAyB,UAAU,MAAM,mBAAmB,SAAS,6CACtE;AAGL,aAAW,IAAI,UAAU,WAAW;;CAMtC,MAAM,wBAAwB,EAAE,WAHd,MAAM,KAAK,WAAW,QAAQ,CAAC,CAC9C,KAAK,eAAe,WAAW,SAAS,CACxC,MAAM,MAAM,UAAU,KAAK,SAAS,cAAc,MAAM,SAAS,CAC3B,EAAE;AAE3C,QAAO;EACL,UAAU;GACR,GAAG;GACH,QAAQ,sBAAsB,sBAAsB;GACrD;EACD;EACD;;AAGH,MAAa,mCACX,aAEA,SAAS,UACN,QAAQ,UAAU,MAAM,WAAW,gBAAgB,CACnD,KAAK,UAAU,MAAM,SAAS;AAEnC,MAAa,gCAAgC,EAC3C,UACA,UACA,mBAKqC;CACrC,MAAM,aAAa,SAAS,UAAU,MAAM,UAAU,MAAM,aAAa,SAAS;AAClF,KAAI,YAAY,WAAW,gBACzB,QAAO,EAAE,MAAM,iBAAiB;AAElC,KAAI,YAAY,WAAW,mBACzB,QAAO;EACL,MAAM;EACN,QAAQ;GAAE,MAAM;GAAoB;GAAU;GAAc;EAC7D;AAEH,QAAO;EACL,MAAM;EACN,QAAQ,aACJ,cAAc,SAAS,0CACvB,cAAc,SAAS;EAC5B;;AAGH,MAAa,mCAAmC,EAC9C,aACA,gBAIqC,EACrC,UAAU;CACR;CACA,mBAAmB;CACnB;CACA,QAAQ;CACR,qBAAqB,EAAE;CACvB,iBAAiB,EAAE;CACpB,EACF;AAED,IAAa,yCAAb,cAA4D,MAAM;CAChE,OAAgB;CAEhB,YAAY,UAAU,wEAAwE;AAC5F,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,MAAa,qCAAqC,EAChD,UACA,qBACA,oBAKU;CACV,MAAM,EAAE,QAAQ,eAAe,GAAG,0BAA0B;AAE5D,KAAI,kBADmB,sBAAsB,sBACT,IAAI,kBAAkB,cACxD,OAAM,IAAI,wCAAwC;AAGpD,KAAI,uBAAuB,oBAAoB,SAAS,WAAW,cACjE,OAAM,IAAI,uCACR,wFACD"}
+{"version":3,"file":"capabilities-DZ0a_o2y.mjs","names":[],"sources":["../src/engine/capabilities.ts"],"sourcesContent":["import type { RawSurveyItem, ValueType } from \"@case-framework/survey-core\";\nimport type {\n  AssistantItemTypeManifest,\n  JsonValue,\n  SurveyAssistantCapabilityManifest,\n  SurveyOperation,\n  SurveyValidationIssue,\n} from \"../protocol\";\nimport { assistantItemTypeManifestSchema } from \"../protocol\";\nimport { buildCapabilityDigest } from \"../protocol/digest\";\n\nexport interface AssistantCapabilityReference {\n  topic: string;\n  title?: string;\n  markdown: string;\n}\n\nexport interface AssistantItemInspection {\n  summary: string;\n  details?: JsonValue;\n}\n\nexport interface AssistantItemCapabilityAdapter {\n  manifest: AssistantItemTypeManifest;\n  references?: AssistantCapabilityReference[];\n  normalizeCreate?: (item: RawSurveyItem) => RawSurveyItem;\n  validateItem?: (item: RawSurveyItem) => SurveyValidationIssue[];\n  supportsOperation?: (operation: SurveyOperation) => boolean;\n  deriveResponseSlots?: (item: RawSurveyItem) => Record<string, ValueType>;\n  inspectItem?: (item: RawSurveyItem) => AssistantItemInspection;\n}\n\nexport interface SurveyAssistantCapabilitySet {\n  manifest: SurveyAssistantCapabilityManifest;\n  byItemType: ReadonlyMap<string, AssistantItemCapabilityAdapter>;\n}\n\nexport const resolveAssistantCapabilityReference = ({\n  capabilities,\n  itemType,\n  topic,\n}: {\n  capabilities: SurveyAssistantCapabilitySet | undefined;\n  itemType: string;\n  topic: string;\n}): AssistantCapabilityReference | undefined =>\n  capabilities?.byItemType\n    .get(itemType)\n    ?.references?.find((reference) => reference.topic === topic);\n\nexport const inspectAssistantItem = ({\n  capabilities,\n  item,\n}: {\n  capabilities: SurveyAssistantCapabilitySet | undefined;\n  item: RawSurveyItem;\n}): AssistantItemInspection | undefined =>\n  capabilities?.byItemType.get(item.itemType)?.inspectItem?.(item);\n\nexport type AssistantItemCreationResolution =\n  | { kind: \"deterministic\" }\n  | {\n      kind: \"ui-intent\";\n      intent: { kind: \"open-create-item\"; itemType: string; parentItemId?: string };\n    }\n  | { kind: \"unsupported\"; reason: string };\n\nexport const createSurveyAssistantCapabilities = (\n  capabilities: readonly AssistantItemCapabilityAdapter[],\n): SurveyAssistantCapabilitySet => {\n  const byItemType = new Map<string, AssistantItemCapabilityAdapter>();\n\n  for (const capability of capabilities) {\n    const manifest = assistantItemTypeManifestSchema.parse(capability.manifest);\n    const itemType = manifest.itemType;\n    if (byItemType.has(itemType)) {\n      throw new Error(`Duplicate survey assistant capability for item type \"${itemType}\".`);\n    }\n    if (\n      manifest.create === \"deterministic\" &&\n      !manifest.supportedOperations.includes(\"create-item\")\n    ) {\n      throw new Error(\n        `Deterministically creatable item type \"${itemType}\" must support \"create-item\".`,\n      );\n    }\n    const declaredReferenceTopics = new Set(manifest.referenceTopics ?? []);\n    for (const reference of capability.references ?? []) {\n      if (!declaredReferenceTopics.has(reference.topic)) {\n        throw new Error(\n          `Capability reference \"${reference.topic}\" for item type \"${itemType}\" is missing from manifest.referenceTopics.`,\n        );\n      }\n    }\n    byItemType.set(itemType, capability);\n  }\n\n  const itemTypes = Array.from(byItemType.values())\n    .map((capability) => capability.manifest)\n    .sort((left, right) => left.itemType.localeCompare(right.itemType));\n  const manifestWithoutDigest = { itemTypes };\n\n  return {\n    manifest: {\n      ...manifestWithoutDigest,\n      digest: buildCapabilityDigest(manifestWithoutDigest),\n    },\n    byItemType,\n  };\n};\n\nexport const getDeterministicCreateItemTypes = (\n  manifest: SurveyAssistantCapabilityManifest,\n): string[] =>\n  manifest.itemTypes\n    .filter((entry) => entry.create === \"deterministic\")\n    .map((entry) => entry.itemType);\n\nexport const resolveAssistantItemCreation = ({\n  itemType,\n  manifest,\n  parentItemId,\n}: {\n  itemType: string;\n  manifest: SurveyAssistantCapabilityManifest;\n  parentItemId?: string;\n}): AssistantItemCreationResolution => {\n  const capability = manifest.itemTypes.find((entry) => entry.itemType === itemType);\n  if (capability?.create === \"deterministic\") {\n    return { kind: \"deterministic\" };\n  }\n  if (capability?.create === \"interactive-only\") {\n    return {\n      kind: \"ui-intent\",\n      intent: { kind: \"open-create-item\", itemType, parentItemId },\n    };\n  }\n  return {\n    kind: \"unsupported\",\n    reason: capability\n      ? `Item type \"${itemType}\" does not support assistant creation.`\n      : `Item type \"${itemType}\" is not installed.`,\n  };\n};\n\nexport const createUnsupportedItemCapability = ({\n  displayName,\n  itemType,\n}: {\n  displayName: string;\n  itemType: string;\n}): AssistantItemCapabilityAdapter => ({\n  manifest: {\n    itemType,\n    capabilityVersion: \"unsupported-v1\",\n    displayName,\n    create: \"unsupported\",\n    supportedOperations: [],\n    contentSurfaces: [],\n  },\n});\n\nexport class SurveyAssistantCapabilityMismatchError extends Error {\n  readonly code = \"survey-assistant-capability-mismatch\";\n\n  constructor(message = \"Survey assistant capabilities changed; start a fresh turn and retry.\") {\n    super(message);\n    this.name = \"SurveyAssistantCapabilityMismatchError\";\n  }\n}\n\nexport const assertSurveyAssistantCapabilities = ({\n  manifest,\n  trustedCapabilities,\n  versionDigest,\n}: {\n  manifest: SurveyAssistantCapabilityManifest;\n  trustedCapabilities?: SurveyAssistantCapabilitySet;\n  versionDigest: string;\n}): void => {\n  const { digest: claimedDigest, ...manifestWithoutDigest } = manifest;\n  const computedDigest = buildCapabilityDigest(manifestWithoutDigest);\n  if (claimedDigest !== computedDigest || versionDigest !== claimedDigest) {\n    throw new SurveyAssistantCapabilityMismatchError();\n  }\n\n  if (trustedCapabilities && trustedCapabilities.manifest.digest !== claimedDigest) {\n    throw new SurveyAssistantCapabilityMismatchError(\n      \"The editor and server use different survey assistant capabilities; refresh and retry.\",\n    );\n  }\n};\n"],"mappings":";;;AAqCA,MAAa,uCAAuC,EAClD,cACA,UACA,YAMA,cAAc,WACX,IAAI,SAAS,EACZ,YAAY,MAAM,cAAc,UAAU,UAAU,MAAM;AAEhE,MAAa,wBAAwB,EACnC,cACA,WAKA,cAAc,WAAW,IAAI,KAAK,SAAS,EAAE,cAAc,KAAK;AAUlE,MAAa,qCACX,iBACiC;CACjC,MAAM,6BAAa,IAAI,KAA6C;AAEpE,MAAK,MAAM,cAAc,cAAc;EACrC,MAAM,WAAW,gCAAgC,MAAM,WAAW,SAAS;EAC3E,MAAM,WAAW,SAAS;AAC1B,MAAI,WAAW,IAAI,SAAS,CAC1B,OAAM,IAAI,MAAM,wDAAwD,SAAS,IAAI;AAEvF,MACE,SAAS,WAAW,mBACpB,CAAC,SAAS,oBAAoB,SAAS,cAAc,CAErD,OAAM,IAAI,MACR,0CAA0C,SAAS,+BACpD;EAEH,MAAM,0BAA0B,IAAI,IAAI,SAAS,mBAAmB,EAAE,CAAC;AACvE,OAAK,MAAM,aAAa,WAAW,cAAc,EAAE,CACjD,KAAI,CAAC,wBAAwB,IAAI,UAAU,MAAM,CAC/C,OAAM,IAAI,MACR,yBAAyB,UAAU,MAAM,mBAAmB,SAAS,6CACtE;AAGL,aAAW,IAAI,UAAU,WAAW;;CAMtC,MAAM,wBAAwB,EAAE,WAHd,MAAM,KAAK,WAAW,QAAQ,CAAC,CAC9C,KAAK,eAAe,WAAW,SAAS,CACxC,MAAM,MAAM,UAAU,KAAK,SAAS,cAAc,MAAM,SAAS,CAC3B,EAAE;AAE3C,QAAO;EACL,UAAU;GACR,GAAG;GACH,QAAQ,sBAAsB,sBAAsB;GACrD;EACD;EACD;;AAGH,MAAa,mCACX,aAEA,SAAS,UACN,QAAQ,UAAU,MAAM,WAAW,gBAAgB,CACnD,KAAK,UAAU,MAAM,SAAS;AAEnC,MAAa,gCAAgC,EAC3C,UACA,UACA,mBAKqC;CACrC,MAAM,aAAa,SAAS,UAAU,MAAM,UAAU,MAAM,aAAa,SAAS;AAClF,KAAI,YAAY,WAAW,gBACzB,QAAO,EAAE,MAAM,iBAAiB;AAElC,KAAI,YAAY,WAAW,mBACzB,QAAO;EACL,MAAM;EACN,QAAQ;GAAE,MAAM;GAAoB;GAAU;GAAc;EAC7D;AAEH,QAAO;EACL,MAAM;EACN,QAAQ,aACJ,cAAc,SAAS,0CACvB,cAAc,SAAS;EAC5B;;AAGH,MAAa,mCAAmC,EAC9C,aACA,gBAIqC,EACrC,UAAU;CACR;CACA,mBAAmB;CACnB;CACA,QAAQ;CACR,qBAAqB,EAAE;CACvB,iBAAiB,EAAE;CACpB,EACF;AAED,IAAa,yCAAb,cAA4D,MAAM;CAChE,OAAgB;CAEhB,YAAY,UAAU,wEAAwE;AAC5F,QAAM,QAAQ;AACd,OAAK,OAAO;;;AAIhB,MAAa,qCAAqC,EAChD,UACA,qBACA,oBAKU;CACV,MAAM,EAAE,QAAQ,eAAe,GAAG,0BAA0B;AAE5D,KAAI,kBADmB,sBAAsB,sBACT,IAAI,kBAAkB,cACxD,OAAM,IAAI,wCAAwC;AAGpD,KAAI,uBAAuB,oBAAoB,SAAS,WAAW,cACjE,OAAM,IAAI,uCACR,wFACD"}

package/dist/{capabilities-DvSKtjAw.d.mts → capabilities-DlC1l6qy.d.mts}

@@ -28,6 +28,7 @@ declare const assistantResponseSlotSchema: z.ZodObject<{
   valueType: z.ZodString;
 }, z.core.$strip>;
 declare const assistantItemAuthoringSchema: z.ZodObject<{
+  compactHint: z.ZodOptional<z.ZodString>;
   configSummary: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 declare const assistantItemTypeManifestSchema: z.ZodObject<{
@@ -96,6 +97,7 @@ declare const assistantItemTypeManifestSchema: z.ZodObject<{
   }, z.core.$strip>>>;
   referenceTopics: z.ZodOptional<z.ZodArray<z.ZodString>>;
   authoring: z.ZodOptional<z.ZodObject<{
+    compactHint: z.ZodOptional<z.ZodString>;
     configSummary: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -167,6 +169,7 @@ declare const surveyAssistantCapabilityManifestSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     referenceTopics: z.ZodOptional<z.ZodArray<z.ZodString>>;
     authoring: z.ZodOptional<z.ZodObject<{
+      compactHint: z.ZodOptional<z.ZodString>;
       configSummary: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
   }, z.core.$strip>>;
@@ -179,4 +182,4 @@ type AssistantItemTypeManifest = z.infer<typeof assistantItemTypeManifestSchema>
 type SurveyAssistantCapabilityManifest = z.infer<typeof surveyAssistantCapabilityManifestSchema>;
 //#endregion
 export { AssistantResponseSlot as a, assistantItemAuthoringSchema as c, assistantResponseSlotSchema as d, surveyAssistantCapabilityManifestSchema as f, AssistantItemTypeManifest as i, assistantItemCreateModeSchema as l, AssistantItemAuthoring as n, SurveyAssistantCapabilityManifest as o, AssistantItemCreateMode as r, assistantContentSurfaceSchema as s, AssistantContentSurface as t, assistantItemTypeManifestSchema as u };
-//# sourceMappingURL=capabilities-DvSKtjAw.d.mts.map
+//# sourceMappingURL=capabilities-DlC1l6qy.d.mts.map

package/dist/capabilities-DlC1l6qy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-DlC1l6qy.d.mts","names":[],"sources":["../src/protocol/capabilities.ts"],"mappings":";;;cAGa,6BAAA,EAA6B,CAAA,CAAA,OAAA;;;;;cAM7B,6BAAA,EAA6B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;cAS7B,2BAAA,EAA2B,CAAA,CAAA,SAAA;;;;cAK3B,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;cAK5B,+BAAA,EAA+B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAc/B,uCAAA,EAAuC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKxC,uBAAA,GAA0B,CAAA,CAAE,KAAA,QAAa,6BAAA;AAAA,KACzC,uBAAA,GAA0B,CAAA,CAAE,KAAA,QAAa,6BAAA;AAAA,KACzC,qBAAA,GAAwB,CAAA,CAAE,KAAA,QAAa,2BAAA;AAAA,KACvC,sBAAA,GAAyB,CAAA,CAAE,KAAA,QAAa,4BAAA;AAAA,KACxC,yBAAA,GAA4B,CAAA,CAAE,KAAA,QAAa,+BAAA;AAAA,KAC3C,iCAAA,GAAoC,CAAA,CAAE,KAAA,QACzC,uCAAA"}

package/dist/capabilities-default.d.mts

@@ -1,4 +1,4 @@
-import { Ft as SurveyAssistantCapabilitySet, jt as AssistantItemCapabilityAdapter } from "./index-CUqbBjkc.mjs";
+import { Ft as SurveyAssistantCapabilitySet, jt as AssistantItemCapabilityAdapter } from "./index-DZ6KBwVR.mjs";
 
 //#region src/capabilities/default.d.ts
 declare const rootItemAssistantCapability: AssistantItemCapabilityAdapter;

package/dist/capabilities-default.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities-default.d.mts","names":[],"sources":["../src/capabilities/default.ts"],"mappings":";;;cAqIa,2BAAA,EAA6B,8BAAA;AAAA,cAY7B,4BAAA,EAA8B,8BAAA;AAAA,cAqB9B,gCAAA,EAAkC,8BAAA;AAAA,cAqBlC,2BAAA,EAA6B,8BAAA;AAAA,cA4B7B,6BAAA,EAA+B,8BAAA;AAAA,cA4E/B,2BAAA,EAA6B,8BAAA;AAAA,cAuD7B,kCAAA,YAAkC,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA;AAAA,cASlC,mCAAA,EAEZ,4BAAA;AAAA,cAEY,mCAAA,GACX,QAAA,aACC,8BAAA"}
+{"version":3,"file":"capabilities-default.d.mts","names":[],"sources":["../src/capabilities/default.ts"],"mappings":";;;cAqIa,2BAAA,EAA6B,8BAAA;AAAA,cAY7B,4BAAA,EAA8B,8BAAA;AAAA,cAqB9B,gCAAA,EAAkC,8BAAA;AAAA,cAqBlC,2BAAA,EAA6B,8BAAA;AAAA,cA4B7B,6BAAA,EAA+B,8BAAA;AAAA,cA4E/B,2BAAA,EAA6B,8BAAA;AAAA,cAyD7B,kCAAA,YAAkC,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA,EAAA,8BAAA;AAAA,cASlC,mCAAA,EAEZ,4BAAA;AAAA,cAEY,mCAAA,GACX,QAAA,aACC,8BAAA"}

package/dist/capabilities-default.mjs

@@ -1,4 +1,4 @@
-import { r as createSurveyAssistantCapabilities } from "./capabilities-B6tvE7fK.mjs";
+import { r as createSurveyAssistantCapabilities } from "./capabilities-DZ0a_o2y.mjs";
 import { ValueType } from "@case-framework/survey-core";
 //#region src/capabilities/default.ts
 const COMMON_OPERATIONS = [
@@ -267,7 +267,7 @@ const choiceItemAssistantCapability = {
 			"expressions",
 			"rich-text-content"
 		],
-		authoring: { configSummary: "Config stores id, maxSelection, shuffleOptions, and options. Use choice option operations for ordinary option edits." }
+		authoring: { configSummary: "Config stores id, maxSelection, shuffleOptions, and options. Put every initial option in create-item config; choice option operations edit only choice items already present in the live snapshot. Embedded field content uses embeddedForms.<choiceOption.id> (case-sensitive), never the option key or embeddedForm id. Form layout values are column counts 1-4; one column makes a lone field full width." }
 	}),
 	references: [QUESTION_REFERENCE],
 	deriveResponseSlots: deriveChoiceResponseSlots
@@ -326,7 +326,10 @@ const formItemAssistantCapability = {
 			"expressions",
 			"rich-text-content"
 		],
-		authoring: { configSummary: "Config stores fieldGroups with layouts and typed fields. Inspect current config and load item-types before editing fields." }
+		authoring: {
+			compactHint: "fields=input|textarea|number|datepicker|switch|select|slider; full date=datepicker/year-month-day",
+			configSummary: "Config stores fieldGroups with typed fields. Supported field types are input, textarea, number, datepicker, switch, select, and slider; the controller type must match the field type. Use datepicker with mode year-month-day for an ordinary full date. Put every initial group and field in create-item config; field operations edit only forms already present in the live snapshot. Layout values are column counts 1-4, not spans; one column makes a lone field full width."
+		}
 	}),
 	references: [QUESTION_REFERENCE],
 	deriveResponseSlots: (item) => deriveFormResponseSlots(item.config)

package/dist/capabilities-default.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities-default.mjs","names":[],"sources":["../src/capabilities/default.ts"],"sourcesContent":["import type { AssistantContentSurface, AssistantItemTypeManifest } from \"../protocol\";\nimport { ValueType, type RawSurveyItem } from \"@case-framework/survey-core\";\nimport {\n  createSurveyAssistantCapabilities,\n  type AssistantItemCapabilityAdapter,\n} from \"../engine/capabilities\";\n\nconst COMMON_OPERATIONS = [\n  \"create-item\",\n  \"update-item-key\",\n  \"update-item-label\",\n  \"update-item-color\",\n  \"update-item-translation\",\n  \"update-placed-image\",\n  \"patch-item-config\",\n  \"remove-item\",\n  \"move-item\",\n  \"survey-json-patch\",\n] satisfies AssistantItemTypeManifest[\"supportedOperations\"];\n\nconst QUESTION_CONTENT_SURFACES: AssistantContentSurface[] = [\n  {\n    key: \"title\",\n    role: \"primary\",\n    format: \"rich\",\n    requiredOnCreate: true,\n    aliases: [\"content\", \"label\", \"prompt\", \"question\", \"text\"],\n  },\n  {\n    key: \"subtitle\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"subheading\", \"subtext\"],\n  },\n  {\n    key: \"topContent\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"preContent\", \"preResponse\"],\n  },\n  {\n    key: \"bottomContent\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"postContent\", \"postResponse\"],\n  },\n  {\n    key: \"cardFooter\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"footer\"],\n  },\n];\n\nconst FIELD_CONTENT_SURFACES: AssistantContentSurface[] = [\n  \"label\",\n  \"description\",\n  \"error\",\n  \"placeholder\",\n  \"unit\",\n  \"checkedLabel\",\n  \"uncheckedLabel\",\n].map((key) => ({\n  key: `fields.<fieldId>.${key}`,\n  role: key === \"error\" ? \"validation\" : \"field\",\n  format: \"rich\",\n  pattern: true,\n}));\n\nconst createManifest = (\n  manifest: Omit<AssistantItemTypeManifest, \"capabilityVersion\">,\n): AssistantItemTypeManifest => ({ capabilityVersion: \"1\", ...manifest });\n\nconst STRUCTURE_REFERENCE = {\n  topic: \"item-types\",\n  markdown:\n    \"Groups are containers. Create a group without child ids, then create or move children through separate operations. Page breaks are standalone structural boundaries.\",\n};\nconst QUESTION_REFERENCE = {\n  topic: \"item-types\",\n  markdown:\n    \"Question titles and supporting text are translations. Configuration stores response behavior; respondent-visible option and field labels use the declared dynamic content surfaces.\",\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst getFieldValueType = (field: Record<string, unknown>): ValueType => {\n  switch (field.type) {\n    case \"number\":\n    case \"slider\":\n      return ValueType.number;\n    case \"datepicker\":\n      return ValueType.date;\n    case \"switch\":\n      return ValueType.boolean;\n    default:\n      return ValueType.string;\n  }\n};\n\nconst deriveFormResponseSlots = (config: unknown, prefix?: string): Record<string, ValueType> => {\n  if (!isRecord(config) || !Array.isArray(config.fieldGroups)) {\n    return {};\n  }\n\n  const slots: Record<string, ValueType> = {};\n  for (const group of config.fieldGroups.filter(isRecord)) {\n    if (!Array.isArray(group.fields)) continue;\n    for (const field of group.fields.filter(isRecord)) {\n      if (typeof field.key !== \"string\" || field.key.length === 0) continue;\n      slots[prefix ? `${prefix}.${field.key}` : field.key] = getFieldValueType(field);\n    }\n  }\n  return slots;\n};\n\nconst deriveChoiceResponseSlots = (item: RawSurveyItem): Record<string, ValueType> => {\n  const config = isRecord(item.config) ? item.config : {};\n  const responseId = typeof config.id === \"string\" && config.id.length > 0 ? config.id : item.id;\n  const slots: Record<string, ValueType> = {\n    [responseId]: config.maxSelection === 1 ? ValueType.reference : ValueType.referenceArray,\n  };\n\n  if (Array.isArray(config.options)) {\n    for (const option of config.options.filter(isRecord)) {\n      if (typeof option.id !== \"string\" || !option.embeddedForm) continue;\n      Object.assign(slots, deriveFormResponseSlots(option.embeddedForm, `embedded.${option.id}`));\n    }\n  }\n  return slots;\n};\n\nexport const rootItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"root\",\n    displayName: \"Survey root\",\n    description: \"The existing root container. A second root cannot be created.\",\n    create: \"unsupported\",\n    supportedOperations: [\"update-item-key\", \"update-item-label\", \"update-item-color\"],\n    contentSurfaces: [],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n};\n\nexport const groupItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"group\",\n    displayName: \"Group\",\n    description: \"A structural container whose children are created as separate items.\",\n    defaultItemKeyPrefix: \"group\",\n    create: \"deterministic\",\n    supportedOperations: [...COMMON_OPERATIONS, \"reorder-items\"],\n    contentSurfaces: [\n      {\n        key: \"title\",\n        role: \"primary\",\n        format: \"rich\",\n        aliases: [\"content\", \"label\", \"name\", \"text\"],\n      },\n    ],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n  references: [STRUCTURE_REFERENCE],\n};\n\nexport const pageBreakItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"page-break\",\n    displayName: \"Page break\",\n    description: \"A structural page boundary.\",\n    defaultItemKeyPrefix: \"page\",\n    create: \"deterministic\",\n    supportedOperations: COMMON_OPERATIONS,\n    contentSurfaces: [\n      {\n        key: \"title\",\n        role: \"primary\",\n        format: \"rich\",\n        aliases: [\"content\", \"label\", \"name\", \"text\"],\n      },\n    ],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n  references: [STRUCTURE_REFERENCE],\n};\n\nexport const infoItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"infoItem\",\n    displayName: \"Info\",\n    description: \"Display-only formatted content without a response slot.\",\n    defaultItemKeyPrefix: \"info\",\n    create: \"deterministic\",\n    supportedOperations: COMMON_OPERATIONS,\n    contentSurfaces: [\n      {\n        key: \"content\",\n        role: \"primary\",\n        format: \"rich\",\n        requiredOnCreate: true,\n        aliases: [\"body\", \"label\", \"prompt\", \"question\", \"text\", \"title\"],\n      },\n    ],\n    referenceTopics: [\"item-types\", \"rich-text-content\"],\n  }),\n  references: [\n    {\n      topic: \"rich-text-content\",\n      markdown:\n        \"Info content uses the rich `content` surface. Markdown strings are not parsed; send structured rich text when formatting matters.\",\n    },\n  ],\n};\n\nexport const choiceItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"choiceItem\",\n    displayName: \"Choice question\",\n    description: \"A single- or multiple-choice question with optional embedded forms.\",\n    defaultItemKeyPrefix: \"choice\",\n    create: \"deterministic\",\n    supportedOperations: [\n      ...COMMON_OPERATIONS,\n      \"add-choice-option\",\n      \"update-choice-option-label\",\n      \"remove-choice-option\",\n      \"reorder-choice-options\",\n      \"upsert-form-field-group\",\n      \"remove-form-field-group\",\n      \"reorder-form-field-groups\",\n      \"upsert-form-field\",\n      \"remove-form-field\",\n      \"move-form-field\",\n      \"set-embedded-form\",\n      \"remove-embedded-form\",\n    ],\n    contentSurfaces: [\n      ...QUESTION_CONTENT_SURFACES,\n      {\n        key: \"options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      ...FIELD_CONTENT_SURFACES.map((surface) => ({\n        ...surface,\n        key: `embeddedForms.<optionId>.${surface.key}`,\n      })),\n      {\n        key: \"embeddedForms.<optionId>.fields.<fieldId>.options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fields.<fieldId>.validations.<validationId>.message\",\n        role: \"validation\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fieldGroups.<groupId>.title\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fieldGroups.<groupId>.description\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n    ],\n    responseSlots: [{ key: \"<responseId>\", valueType: \"reference|referenceArray\" }],\n    referenceTopics: [\n      \"item-types\",\n      \"embedded-forms\",\n      \"localization\",\n      \"expressions\",\n      \"rich-text-content\",\n    ],\n    authoring: {\n      configSummary:\n        \"Config stores id, maxSelection, shuffleOptions, and options. Use choice option operations for ordinary option edits.\",\n    },\n  }),\n  references: [QUESTION_REFERENCE],\n  deriveResponseSlots: deriveChoiceResponseSlots,\n};\n\nexport const formItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"formItem\",\n    displayName: \"Form\",\n    description: \"A form with groups, typed fields, validations, and select options.\",\n    defaultItemKeyPrefix: \"form\",\n    create: \"deterministic\",\n    supportedOperations: [\n      ...COMMON_OPERATIONS,\n      \"upsert-form-field-group\",\n      \"remove-form-field-group\",\n      \"reorder-form-field-groups\",\n      \"upsert-form-field\",\n      \"remove-form-field\",\n      \"move-form-field\",\n    ],\n    contentSurfaces: [\n      ...QUESTION_CONTENT_SURFACES,\n      {\n        key: \"fieldGroups.<groupId>.title\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"fieldGroups.<groupId>.description\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      ...FIELD_CONTENT_SURFACES,\n      {\n        key: \"fields.<fieldId>.options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"fields.<fieldId>.validations.<validationId>.message\",\n        role: \"validation\",\n        format: \"rich\",\n        pattern: true,\n      },\n    ],\n    responseSlots: [{ key: \"<fieldKey>\", valueType: \"field-dependent\" }],\n    referenceTopics: [\"item-types\", \"localization\", \"expressions\", \"rich-text-content\"],\n    authoring: {\n      configSummary:\n        \"Config stores fieldGroups with layouts and typed fields. Inspect current config and load item-types before editing fields.\",\n    },\n  }),\n  references: [QUESTION_REFERENCE],\n  deriveResponseSlots: (item) => deriveFormResponseSlots(item.config),\n};\n\nexport const defaultSurveyAssistantCapabilities = [\n  rootItemAssistantCapability,\n  groupItemAssistantCapability,\n  pageBreakItemAssistantCapability,\n  infoItemAssistantCapability,\n  choiceItemAssistantCapability,\n  formItemAssistantCapability,\n] as const;\n\nexport const defaultSurveyAssistantCapabilitySet = createSurveyAssistantCapabilities(\n  defaultSurveyAssistantCapabilities,\n);\n\nexport const getDefaultSurveyAssistantCapability = (\n  itemType: string,\n): AssistantItemCapabilityAdapter | undefined =>\n  defaultSurveyAssistantCapabilitySet.byItemType.get(itemType);\n"],"mappings":"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"}
+{"version":3,"file":"capabilities-default.mjs","names":[],"sources":["../src/capabilities/default.ts"],"sourcesContent":["import type { AssistantContentSurface, AssistantItemTypeManifest } from \"../protocol\";\nimport { ValueType, type RawSurveyItem } from \"@case-framework/survey-core\";\nimport {\n  createSurveyAssistantCapabilities,\n  type AssistantItemCapabilityAdapter,\n} from \"../engine/capabilities\";\n\nconst COMMON_OPERATIONS = [\n  \"create-item\",\n  \"update-item-key\",\n  \"update-item-label\",\n  \"update-item-color\",\n  \"update-item-translation\",\n  \"update-placed-image\",\n  \"patch-item-config\",\n  \"remove-item\",\n  \"move-item\",\n  \"survey-json-patch\",\n] satisfies AssistantItemTypeManifest[\"supportedOperations\"];\n\nconst QUESTION_CONTENT_SURFACES: AssistantContentSurface[] = [\n  {\n    key: \"title\",\n    role: \"primary\",\n    format: \"rich\",\n    requiredOnCreate: true,\n    aliases: [\"content\", \"label\", \"prompt\", \"question\", \"text\"],\n  },\n  {\n    key: \"subtitle\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"subheading\", \"subtext\"],\n  },\n  {\n    key: \"topContent\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"preContent\", \"preResponse\"],\n  },\n  {\n    key: \"bottomContent\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"postContent\", \"postResponse\"],\n  },\n  {\n    key: \"cardFooter\",\n    role: \"secondary\",\n    format: \"rich\",\n    aliases: [\"footer\"],\n  },\n];\n\nconst FIELD_CONTENT_SURFACES: AssistantContentSurface[] = [\n  \"label\",\n  \"description\",\n  \"error\",\n  \"placeholder\",\n  \"unit\",\n  \"checkedLabel\",\n  \"uncheckedLabel\",\n].map((key) => ({\n  key: `fields.<fieldId>.${key}`,\n  role: key === \"error\" ? \"validation\" : \"field\",\n  format: \"rich\",\n  pattern: true,\n}));\n\nconst createManifest = (\n  manifest: Omit<AssistantItemTypeManifest, \"capabilityVersion\">,\n): AssistantItemTypeManifest => ({ capabilityVersion: \"1\", ...manifest });\n\nconst STRUCTURE_REFERENCE = {\n  topic: \"item-types\",\n  markdown:\n    \"Groups are containers. Create a group without child ids, then create or move children through separate operations. Page breaks are standalone structural boundaries.\",\n};\nconst QUESTION_REFERENCE = {\n  topic: \"item-types\",\n  markdown:\n    \"Question titles and supporting text are translations. Configuration stores response behavior; respondent-visible option and field labels use the declared dynamic content surfaces.\",\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst getFieldValueType = (field: Record<string, unknown>): ValueType => {\n  switch (field.type) {\n    case \"number\":\n    case \"slider\":\n      return ValueType.number;\n    case \"datepicker\":\n      return ValueType.date;\n    case \"switch\":\n      return ValueType.boolean;\n    default:\n      return ValueType.string;\n  }\n};\n\nconst deriveFormResponseSlots = (config: unknown, prefix?: string): Record<string, ValueType> => {\n  if (!isRecord(config) || !Array.isArray(config.fieldGroups)) {\n    return {};\n  }\n\n  const slots: Record<string, ValueType> = {};\n  for (const group of config.fieldGroups.filter(isRecord)) {\n    if (!Array.isArray(group.fields)) continue;\n    for (const field of group.fields.filter(isRecord)) {\n      if (typeof field.key !== \"string\" || field.key.length === 0) continue;\n      slots[prefix ? `${prefix}.${field.key}` : field.key] = getFieldValueType(field);\n    }\n  }\n  return slots;\n};\n\nconst deriveChoiceResponseSlots = (item: RawSurveyItem): Record<string, ValueType> => {\n  const config = isRecord(item.config) ? item.config : {};\n  const responseId = typeof config.id === \"string\" && config.id.length > 0 ? config.id : item.id;\n  const slots: Record<string, ValueType> = {\n    [responseId]: config.maxSelection === 1 ? ValueType.reference : ValueType.referenceArray,\n  };\n\n  if (Array.isArray(config.options)) {\n    for (const option of config.options.filter(isRecord)) {\n      if (typeof option.id !== \"string\" || !option.embeddedForm) continue;\n      Object.assign(slots, deriveFormResponseSlots(option.embeddedForm, `embedded.${option.id}`));\n    }\n  }\n  return slots;\n};\n\nexport const rootItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"root\",\n    displayName: \"Survey root\",\n    description: \"The existing root container. A second root cannot be created.\",\n    create: \"unsupported\",\n    supportedOperations: [\"update-item-key\", \"update-item-label\", \"update-item-color\"],\n    contentSurfaces: [],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n};\n\nexport const groupItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"group\",\n    displayName: \"Group\",\n    description: \"A structural container whose children are created as separate items.\",\n    defaultItemKeyPrefix: \"group\",\n    create: \"deterministic\",\n    supportedOperations: [...COMMON_OPERATIONS, \"reorder-items\"],\n    contentSurfaces: [\n      {\n        key: \"title\",\n        role: \"primary\",\n        format: \"rich\",\n        aliases: [\"content\", \"label\", \"name\", \"text\"],\n      },\n    ],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n  references: [STRUCTURE_REFERENCE],\n};\n\nexport const pageBreakItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"page-break\",\n    displayName: \"Page break\",\n    description: \"A structural page boundary.\",\n    defaultItemKeyPrefix: \"page\",\n    create: \"deterministic\",\n    supportedOperations: COMMON_OPERATIONS,\n    contentSurfaces: [\n      {\n        key: \"title\",\n        role: \"primary\",\n        format: \"rich\",\n        aliases: [\"content\", \"label\", \"name\", \"text\"],\n      },\n    ],\n    referenceTopics: [\"survey-data-model\", \"item-types\"],\n  }),\n  references: [STRUCTURE_REFERENCE],\n};\n\nexport const infoItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"infoItem\",\n    displayName: \"Info\",\n    description: \"Display-only formatted content without a response slot.\",\n    defaultItemKeyPrefix: \"info\",\n    create: \"deterministic\",\n    supportedOperations: COMMON_OPERATIONS,\n    contentSurfaces: [\n      {\n        key: \"content\",\n        role: \"primary\",\n        format: \"rich\",\n        requiredOnCreate: true,\n        aliases: [\"body\", \"label\", \"prompt\", \"question\", \"text\", \"title\"],\n      },\n    ],\n    referenceTopics: [\"item-types\", \"rich-text-content\"],\n  }),\n  references: [\n    {\n      topic: \"rich-text-content\",\n      markdown:\n        \"Info content uses the rich `content` surface. Markdown strings are not parsed; send structured rich text when formatting matters.\",\n    },\n  ],\n};\n\nexport const choiceItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"choiceItem\",\n    displayName: \"Choice question\",\n    description: \"A single- or multiple-choice question with optional embedded forms.\",\n    defaultItemKeyPrefix: \"choice\",\n    create: \"deterministic\",\n    supportedOperations: [\n      ...COMMON_OPERATIONS,\n      \"add-choice-option\",\n      \"update-choice-option-label\",\n      \"remove-choice-option\",\n      \"reorder-choice-options\",\n      \"upsert-form-field-group\",\n      \"remove-form-field-group\",\n      \"reorder-form-field-groups\",\n      \"upsert-form-field\",\n      \"remove-form-field\",\n      \"move-form-field\",\n      \"set-embedded-form\",\n      \"remove-embedded-form\",\n    ],\n    contentSurfaces: [\n      ...QUESTION_CONTENT_SURFACES,\n      {\n        key: \"options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      ...FIELD_CONTENT_SURFACES.map((surface) => ({\n        ...surface,\n        key: `embeddedForms.<optionId>.${surface.key}`,\n      })),\n      {\n        key: \"embeddedForms.<optionId>.fields.<fieldId>.options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fields.<fieldId>.validations.<validationId>.message\",\n        role: \"validation\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fieldGroups.<groupId>.title\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"embeddedForms.<optionId>.fieldGroups.<groupId>.description\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n    ],\n    responseSlots: [{ key: \"<responseId>\", valueType: \"reference|referenceArray\" }],\n    referenceTopics: [\n      \"item-types\",\n      \"embedded-forms\",\n      \"localization\",\n      \"expressions\",\n      \"rich-text-content\",\n    ],\n    authoring: {\n      configSummary:\n        \"Config stores id, maxSelection, shuffleOptions, and options. Put every initial option in create-item config; choice option operations edit only choice items already present in the live snapshot. Embedded field content uses embeddedForms.<choiceOption.id> (case-sensitive), never the option key or embeddedForm id. Form layout values are column counts 1-4; one column makes a lone field full width.\",\n    },\n  }),\n  references: [QUESTION_REFERENCE],\n  deriveResponseSlots: deriveChoiceResponseSlots,\n};\n\nexport const formItemAssistantCapability: AssistantItemCapabilityAdapter = {\n  manifest: createManifest({\n    itemType: \"formItem\",\n    displayName: \"Form\",\n    description: \"A form with groups, typed fields, validations, and select options.\",\n    defaultItemKeyPrefix: \"form\",\n    create: \"deterministic\",\n    supportedOperations: [\n      ...COMMON_OPERATIONS,\n      \"upsert-form-field-group\",\n      \"remove-form-field-group\",\n      \"reorder-form-field-groups\",\n      \"upsert-form-field\",\n      \"remove-form-field\",\n      \"move-form-field\",\n    ],\n    contentSurfaces: [\n      ...QUESTION_CONTENT_SURFACES,\n      {\n        key: \"fieldGroups.<groupId>.title\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"fieldGroups.<groupId>.description\",\n        role: \"field\",\n        format: \"rich\",\n        pattern: true,\n      },\n      ...FIELD_CONTENT_SURFACES,\n      {\n        key: \"fields.<fieldId>.options.<optionId>.label\",\n        role: \"option\",\n        format: \"rich\",\n        pattern: true,\n      },\n      {\n        key: \"fields.<fieldId>.validations.<validationId>.message\",\n        role: \"validation\",\n        format: \"rich\",\n        pattern: true,\n      },\n    ],\n    responseSlots: [{ key: \"<fieldKey>\", valueType: \"field-dependent\" }],\n    referenceTopics: [\"item-types\", \"localization\", \"expressions\", \"rich-text-content\"],\n    authoring: {\n      compactHint:\n        \"fields=input|textarea|number|datepicker|switch|select|slider; full date=datepicker/year-month-day\",\n      configSummary:\n        \"Config stores fieldGroups with typed fields. Supported field types are input, textarea, number, datepicker, switch, select, and slider; the controller type must match the field type. Use datepicker with mode year-month-day for an ordinary full date. Put every initial group and field in create-item config; field operations edit only forms already present in the live snapshot. Layout values are column counts 1-4, not spans; one column makes a lone field full width.\",\n    },\n  }),\n  references: [QUESTION_REFERENCE],\n  deriveResponseSlots: (item) => deriveFormResponseSlots(item.config),\n};\n\nexport const defaultSurveyAssistantCapabilities = [\n  rootItemAssistantCapability,\n  groupItemAssistantCapability,\n  pageBreakItemAssistantCapability,\n  infoItemAssistantCapability,\n  choiceItemAssistantCapability,\n  formItemAssistantCapability,\n] as const;\n\nexport const defaultSurveyAssistantCapabilitySet = createSurveyAssistantCapabilities(\n  defaultSurveyAssistantCapabilities,\n);\n\nexport const getDefaultSurveyAssistantCapability = (\n  itemType: string,\n): AssistantItemCapabilityAdapter | undefined =>\n  defaultSurveyAssistantCapabilitySet.byItemType.get(itemType);\n"],"mappings":"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"}

package/dist/{constants-Jw0k8ojS.d.mts → constants-56jf_4ls.d.mts}

@@ -1,6 +1,6 @@
-import { cn as SurveyDocumentSnapshot } from "./index-TFtvBiSQ.mjs";
-import { Ft as SurveyAssistantCapabilitySet, g as TurnChangeCollector, xt as SurveyAssistantEngineContext } from "./index-CUqbBjkc.mjs";
-import { n as SurveyAssistantModelAttachment, t as SurveyAssistantAttachmentAccess } from "./thread-documents-DamIq9Od.mjs";
+import { dn as SurveyDocumentVersion, un as SurveyDocumentSnapshot } from "./index-DVxVyhAu.mjs";
+import { Ft as SurveyAssistantCapabilitySet, g as TurnChangeCollector, xt as SurveyAssistantEngineContext } from "./index-DZ6KBwVR.mjs";
+import { n as SurveyAssistantModelAttachment, t as SurveyAssistantAttachmentAccess } from "./thread-documents-BlxNjc7S.mjs";
 import { RequestContext } from "@mastra/core/request-context";
 
 //#region src/server/request-context.d.ts
@@ -10,13 +10,32 @@ interface SurveyAssistantInvocationContext {
 interface SurveyAssistantIdentityContext {
   authority: "experimental-client-request" | "authenticated-host";
   resourceId: string;
+  surveyId?: string;
   threadId: string;
 }
 interface SurveyAssistantModelSelection {
   id: string;
   model: string;
 }
-type SurveyAssistantSnapshotSource = "full" | "missing";
+type SurveyAssistantDocumentTransition = {
+  status: "no-baseline";
+} | {
+  status: "session-changed";
+  previousHistoryIndex: number;
+  currentHistoryIndex: number;
+} | {
+  status: "unchanged";
+  previousHistoryIndex: number;
+  currentHistoryIndex: number;
+  capabilitiesChanged: boolean;
+} | {
+  status: "changed";
+  previousHistoryIndex: number;
+  currentHistoryIndex: number;
+  historyDirection: "backward" | "forward" | "same-index";
+  recordedSources: Array<"user" | "system" | "assistant">;
+  capabilitiesChanged: boolean;
+};
 interface SurveyAssistantRequestContext {
   invocation: SurveyAssistantInvocationContext;
   turnId: string;
@@ -27,7 +46,7 @@ interface SurveyAssistantRequestContext {
   applyPolicy?: "auto" | "review" | "deny";
   mastra__resourceId?: string;
   mastra__threadId?: string;
-  snapshotSource?: SurveyAssistantSnapshotSource;
+  documentTransition?: SurveyAssistantDocumentTransition;
   engineContext?: SurveyAssistantEngineContext;
   documentSnapshot?: SurveyDocumentSnapshot;
   modelAttachments?: SurveyAssistantModelAttachment[];
@@ -35,11 +54,19 @@ interface SurveyAssistantRequestContext {
   modelSelection?: SurveyAssistantModelSelection;
 }
 declare const parseSurveyAssistantSnapshot: (value: unknown) => SurveyDocumentSnapshot | null;
+declare const parseSurveyAssistantPreviousSettledVersion: (value: unknown) => SurveyDocumentVersion | null;
+declare const deriveSurveyAssistantDocumentTransition: ({
+  current,
+  previous
+}: {
+  current: SurveyDocumentSnapshot | null;
+  previous: SurveyDocumentVersion | null;
+}) => SurveyAssistantDocumentTransition | undefined;
 declare const buildSurveyAssistantRequestContext: ({
   changeCollector,
   identity,
   snapshot,
-  snapshotSource,
+  previousSettledVersion,
   trustedCapabilities,
   attachmentAccess,
   modelAttachments,
@@ -48,7 +75,7 @@ declare const buildSurveyAssistantRequestContext: ({
   changeCollector: TurnChangeCollector;
   identity: SurveyAssistantIdentityContext;
   snapshot: SurveyDocumentSnapshot | null;
-  snapshotSource?: SurveyAssistantSnapshotSource;
+  previousSettledVersion?: SurveyDocumentVersion | null;
   trustedCapabilities?: SurveyAssistantCapabilitySet;
   attachmentAccess?: SurveyAssistantAttachmentAccess;
   modelAttachments?: SurveyAssistantModelAttachment[];
@@ -63,5 +90,5 @@ declare const requireSurveyAssistantTurnState: (requestContext: RequestContext<S
 declare const SURVEY_ASSISTANT_AGENT_ID = "survey-assistant-agent";
 declare const SURVEY_ASSISTANT_TASK_AGENT_ID = "survey-assistant-task-agent";
 //#endregion
-export { SurveyAssistantRequestContext as a, parseSurveyAssistantSnapshot as c, SurveyAssistantModelSelection as i, requireSurveyAssistantTurnState as l, SURVEY_ASSISTANT_TASK_AGENT_ID as n, SurveyAssistantSnapshotSource as o, SurveyAssistantIdentityContext as r, buildSurveyAssistantRequestContext as s, SURVEY_ASSISTANT_AGENT_ID as t };
-//# sourceMappingURL=constants-Jw0k8ojS.d.mts.map
+export { SurveyAssistantModelSelection as a, deriveSurveyAssistantDocumentTransition as c, requireSurveyAssistantTurnState as d, SurveyAssistantIdentityContext as i, parseSurveyAssistantPreviousSettledVersion as l, SURVEY_ASSISTANT_TASK_AGENT_ID as n, SurveyAssistantRequestContext as o, SurveyAssistantDocumentTransition as r, buildSurveyAssistantRequestContext as s, SURVEY_ASSISTANT_AGENT_ID as t, parseSurveyAssistantSnapshot as u };
+//# sourceMappingURL=constants-56jf_4ls.d.mts.map

package/dist/constants-56jf_4ls.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-56jf_4ls.d.mts","names":[],"sources":["../src/server/request-context.ts","../src/server/constants.ts"],"mappings":";;;;;;UAuBiB,gCAAA;EACf,IAAA;AAAA;AAAA,UAGe,8BAAA;EACf,SAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;AAAA;AAAA,UAGe,6BAAA;EACf,EAAA;EACA,KAAA;AAAA;AAAA,KAGU,iCAAA;EACN,MAAA;AAAA;EAEA,MAAA;EACA,oBAAA;EACA,mBAAA;AAAA;EAGA,MAAA;EACA,oBAAA;EACA,mBAAA;EACA,mBAAA;AAAA;EAGA,MAAA;EACA,oBAAA;EACA,mBAAA;EACA,gBAAA;EACA,eAAA,EAAiB,KAAA;EACjB,mBAAA;AAAA;AAAA,UAGW,6BAAA;EACf,UAAA,EAAY,gCAAA;EACZ,MAAA;EACA,eAAA,EAAiB,mBAAA;EACjB,QAAA,EAAU,8BAAA;EACV,uBAAA;EACA,kBAAA;EACA,WAAA;EACA,kBAAA;EACA,gBAAA;EACA,kBAAA,GAAqB,iCAAA;EACrB,aAAA,GAAgB,4BAAA;EAChB,gBAAA,GAAmB,sBAAA;EACnB,gBAAA,GAAmB,8BAAA;EACnB,gBAAA,GAAmB,+BAAA;EACnB,cAAA,GAAiB,6BAAA;AAAA;AAAA,cAGN,4BAAA,GAAgC,KAAA,cAAiB,sBAAA;AAAA,cAQjD,0CAAA,GACX,KAAA,cACC,qBAAA;AAAA,cAQU,uCAAA;EAA2C,OAAA;EAAA;AAAA;EAItD,OAAA,EAAS,sBAAA;EACT,QAAA,EAAU,qBAAA;AAAA,MACR,iCAAA;AAAA,cAqDS,kCAAA;EAAsC,eAAA;EAAA,QAAA;EAAA,QAAA;EAAA,sBAAA;EAAA,mBAAA;EAAA,gBAAA;EAAA,gBAAA;EAAA;AAAA;EAUjD,eAAA,EAAiB,mBAAA;EACjB,QAAA,EAAU,8BAAA;EACV,QAAA,EAAU,sBAAA;EACV,sBAAA,GAAyB,qBAAA;EACzB,mBAAA,GAAsB,4BAAA;EACtB,gBAAA,GAAmB,+BAAA;EACnB,gBAAA,GAAmB,8BAAA;EACnB,cAAA,GAAiB,6BAAA;AAAA,MACf,cAAA,CAAe,6BAAA;AAAA,cAyCN,+BAAA,GACX,cAAA,EAAgB,cAAA,CAAe,6BAAA;;;;;;cCxNpB,yBAAA;AAAA,cACA,8BAAA"}

package/dist/{controller-proxy-BRDusFiO.d.mts → controller-proxy-2VH0b_5E.d.mts}

@@ -1,9 +1,32 @@
-import { A as SurveyAssistantSuggestItemKeyResult, B as SurveyAssistantTranslateContentResult, F as SurveyAssistantTaskInvocationMode, M as SurveyAssistantSuggestItemLabelResult, P as SurveyAssistantTaskContext, f as SurveyBatchApplyResult, i as SurveyApplyResult, j as SurveyAssistantSuggestItemLabelInput, k as SurveyAssistantSuggestItemKeyInput, on as SurveyAssistantSnapshot, p as SurveyChangeSet, z as SurveyAssistantTranslateContentInput } from "./index-TFtvBiSQ.mjs";
+import { A as SurveyAssistantSuggestItemKeyResult, B as SurveyAssistantTranslateContentResult, F as SurveyAssistantTaskInvocationMode, M as SurveyAssistantSuggestItemLabelResult, P as SurveyAssistantTaskContext, cn as SurveyAssistantSnapshot, f as SurveyBatchApplyResult, fn as SurveyEditorUIContext, i as SurveyApplyResult, it as SurveyAssistantThread, j as SurveyAssistantSuggestItemLabelInput, k as SurveyAssistantSuggestItemKeyInput, p as SurveyChangeSet, z as SurveyAssistantTranslateContentInput } from "./index-DVxVyhAu.mjs";
+import { FileUIPart } from "ai";
 
+//#region src/react/thread-launcher.d.ts
+type SurveyAssistantLaunchUIContext = Partial<Omit<SurveyEditorUIContext, "history">>;
+interface SurveyAssistantThreadLaunch {
+  /** User-visible prompt submitted as the first message in the new thread. */
+  prompt: string;
+  files?: FileUIPart[];
+  /** Optional manual thread title. The prompt-derived automatic title is used by default. */
+  title?: string;
+  /** Turn-local editor context merged into the snapshot captured when the prompt is submitted. */
+  uiContext?: SurveyAssistantLaunchUIContext;
+}
+interface SurveyAssistantThreadLauncher {
+  /**
+   * Creates a new thread and submits its first prompt when a connected panel is ready.
+   * Calls made before the panel mounts are queued.
+   */
+  startThread(input: SurveyAssistantThreadLaunch): Promise<SurveyAssistantThread>;
+}
+declare const createSurveyAssistantThreadLauncher: () => SurveyAssistantThreadLauncher;
+//#endregion
 //#region src/react/task-client.d.ts
 interface SurveyAssistantTaskClientOptions {
   api?: string;
   getModelId?: () => string | undefined;
+  resourceId?: string;
+  surveyId?: string;
 }
 interface SurveyAssistantTaskExecutionOptions {
   mode?: SurveyAssistantTaskInvocationMode;
@@ -29,7 +52,9 @@ interface SurveyAssistantTaskExecutor {
 }
 declare const createSurveyAssistantTaskClient: ({
   api,
-  getModelId
+  getModelId,
+  resourceId,
+  surveyId
 }?: SurveyAssistantTaskClientOptions) => SurveyAssistantTaskClient;
 declare const createSurveyAssistantTaskExecutor: (options?: SurveyAssistantTaskClientOptions) => SurveyAssistantTaskExecutor;
 //#endregion
@@ -53,5 +78,5 @@ declare const createSurveyAssistantControllerProxy: (getController: () => Survey
 }?: CreateSurveyAssistantControllerProxyOptions) => SurveyAssistantController;
 declare const createSurveyAssistantControllerBridge: (options?: CreateSurveyAssistantControllerProxyOptions) => SurveyAssistantControllerBridge;
 //#endregion
-export { SurveyAssistantController as a, SurveyAssistantTaskExecutionOptions as c, SurveyAssistantTaskExecutorRequestOptions as d, createSurveyAssistantTaskClient as f, createSurveyAssistantControllerProxy as i, SurveyAssistantTaskExecutor as l, SurveyAssistantControllerBridge as n, SurveyAssistantTaskClient as o, createSurveyAssistantTaskExecutor as p, createSurveyAssistantControllerBridge as r, SurveyAssistantTaskClientOptions as s, CreateSurveyAssistantControllerProxyOptions as t, SurveyAssistantTaskExecutorCacheContext as u };
-//# sourceMappingURL=controller-proxy-BRDusFiO.d.mts.map
+export { createSurveyAssistantThreadLauncher as _, SurveyAssistantController as a, SurveyAssistantTaskExecutionOptions as c, SurveyAssistantTaskExecutorRequestOptions as d, createSurveyAssistantTaskClient as f, SurveyAssistantThreadLauncher as g, SurveyAssistantThreadLaunch as h, createSurveyAssistantControllerProxy as i, SurveyAssistantTaskExecutor as l, SurveyAssistantLaunchUIContext as m, SurveyAssistantControllerBridge as n, SurveyAssistantTaskClient as o, createSurveyAssistantTaskExecutor as p, createSurveyAssistantControllerBridge as r, SurveyAssistantTaskClientOptions as s, CreateSurveyAssistantControllerProxyOptions as t, SurveyAssistantTaskExecutorCacheContext as u };
+//# sourceMappingURL=controller-proxy-2VH0b_5E.d.mts.map

package/dist/controller-proxy-2VH0b_5E.d.mts.map

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