@case-framework/survey-assistant 0.7.0 → 0.9.0

package/dist/index-Tnqv-yKW.d.mts

@@ -1,777 +0,0 @@
-import { i as AssistantItemTypeManifest, o as SurveyAssistantCapabilityManifest } from "./capabilities-DVTfogjv.mjs";
-import { p as SurveyAssistantTaskContext } from "./index-nhrgbgO5.mjs";
-import { Ct as SurveyDocumentSnapshot, F as SurveyValidationIssue, I as SurveyValidationResult, N as SurveyOperation, Pt as JsonValue$1, f as SurveyAssistantTurnFinal, h as SurveyChangeSet, wt as SurveyDocumentVersion } from "./lifecycle-Bx0aq_4S.mjs";
-import { z } from "zod";
-import { Content, JsonExpression, JsonPatchOperation, RawSurvey, RawSurveyItem, ResponseValue, SurveyExpressionReferenceDiagnostic, SurveyExpressionResponseSlot, SurveyTranslations, ValueType } from "@case-framework/survey-core";
-import { FormAuthoringMode, getFormAuthoringMode as getFormAuthoringMode$1, hasSingleFormField, isCompatibleSimpleFieldUpsert as isCompatibleSimpleFieldUpsert$1, isValidSimpleFormConfig as isValidSimpleFormConfig$1, normalizeFormAuthoringConfig as normalizeFormAuthoringConfig$1, transitionFormAuthoringMode as transitionFormAuthoringMode$1 } from "@case-framework/survey-items/form";
-
-//#region src/engine/capabilities.d.ts
-interface AssistantCapabilityReference {
-  topic: string;
-  title?: string;
-  markdown: string;
-}
-interface AssistantItemInspection {
-  summary: string;
-  details?: JsonValue$1;
-}
-interface AssistantItemCapabilityAdapter {
-  manifest: AssistantItemTypeManifest;
-  references?: AssistantCapabilityReference[];
-  normalizeCreate?: (item: RawSurveyItem) => RawSurveyItem;
-  validateItem?: (item: RawSurveyItem) => SurveyValidationIssue[];
-  supportsOperation?: (operation: SurveyOperation) => boolean;
-  deriveResponseSlots?: (item: RawSurveyItem) => Record<string, ValueType>;
-  inspectItem?: (item: RawSurveyItem) => AssistantItemInspection;
-}
-interface SurveyAssistantCapabilitySet {
-  manifest: SurveyAssistantCapabilityManifest;
-  byItemType: ReadonlyMap<string, AssistantItemCapabilityAdapter>;
-}
-declare const resolveAssistantCapabilityReference: ({
-  capabilities,
-  itemType,
-  topic
-}: {
-  capabilities: SurveyAssistantCapabilitySet | undefined;
-  itemType: string;
-  topic: string;
-}) => AssistantCapabilityReference | undefined;
-declare const inspectAssistantItem: ({
-  capabilities,
-  item
-}: {
-  capabilities: SurveyAssistantCapabilitySet | undefined;
-  item: RawSurveyItem;
-}) => AssistantItemInspection | undefined;
-type AssistantItemCreationResolution = {
-  kind: "deterministic";
-} | {
-  kind: "ui-intent";
-  intent: {
-    kind: "open-create-item";
-    itemType: string;
-    parentItemId?: string;
-  };
-} | {
-  kind: "unsupported";
-  reason: string;
-};
-declare const createSurveyAssistantCapabilities: (capabilities: readonly AssistantItemCapabilityAdapter[]) => SurveyAssistantCapabilitySet;
-declare const getDeterministicCreateItemTypes: (manifest: SurveyAssistantCapabilityManifest) => string[];
-declare const resolveAssistantItemCreation: ({
-  itemType,
-  manifest,
-  parentItemId
-}: {
-  itemType: string;
-  manifest: SurveyAssistantCapabilityManifest;
-  parentItemId?: string;
-}) => AssistantItemCreationResolution;
-declare const createUnsupportedItemCapability: ({
-  displayName,
-  itemType
-}: {
-  displayName: string;
-  itemType: string;
-}) => AssistantItemCapabilityAdapter;
-declare class SurveyAssistantCapabilityMismatchError extends Error {
-  readonly code = "survey-assistant-capability-mismatch";
-  constructor(message?: string);
-}
-declare const assertSurveyAssistantCapabilities: ({
-  manifest,
-  trustedCapabilities,
-  versionDigest
-}: {
-  manifest: SurveyAssistantCapabilityManifest;
-  trustedCapabilities?: SurveyAssistantCapabilitySet;
-  versionDigest: string;
-}) => void;
-//#endregion
-//#region src/engine/context.d.ts
-type SurveyAssistantResponseSlotTypes = Record<string, ValueType | undefined>;
-interface SurveyAssistantInspectionOutlineNode {
-  itemId: string;
-  parentId?: string;
-  depth: number;
-  itemType: string;
-  key: string;
-  fullKey: string;
-  itemLabel?: string;
-  childCount: number;
-}
-interface SurveyAssistantInspectionFocus {
-  focusItemId: string;
-  parentItemId?: string;
-  pathItemIds: string[];
-  siblingItemIds: string[];
-  childItemIds: string[];
-}
-interface SurveyAssistantInspectionItemNode {
-  itemId: string;
-  itemType: string;
-  itemKey: string;
-  fullKey: string;
-  itemLabel?: string;
-  siblingKeys: string[];
-  translations: Array<{
-    locale: string;
-    contentKey: string;
-    text: string;
-  }>;
-  descendants: SurveyAssistantInspectionItemNode[];
-}
-interface SurveyAssistantInspectionKeyEntry {
-  itemId: string;
-  itemType: string;
-  key: string;
-  fullKey: string;
-  itemLabel?: string;
-  path: string[];
-}
-/** Deterministic, request-local lookup data derived from the canonical document. */
-interface SurveyAssistantInspectionIndex {
-  surveyKey?: string;
-  locales: string[];
-  /** All survey items except the structural root group. */
-  itemCount: number;
-  outline: SurveyAssistantInspectionOutlineNode[];
-  focus?: SurveyAssistantInspectionFocus;
-  focusItem?: SurveyAssistantInspectionItemNode;
-  keyIndex: SurveyAssistantInspectionKeyEntry[];
-  responseSlots: string[];
-  focusItemTreeTruncated: boolean;
-}
-/** Request-local derived state built from one authoritative survey document. */
-interface SurveyAssistantEngineContext {
-  document: SurveyDocumentSnapshot;
-  version: SurveyDocumentVersion;
-  survey: RawSurvey;
-  ui: SurveyDocumentSnapshot["ui"];
-  capabilities: SurveyAssistantCapabilityManifest;
-  responseSlotTypes: SurveyAssistantResponseSlotTypes;
-  inspection: SurveyAssistantInspectionIndex;
-  trustedCapabilities?: SurveyAssistantCapabilitySet;
-}
-interface CreateSurveyAssistantEngineContextOptions {
-  focusItemId?: string;
-}
-declare const deriveResponseSlotTypes: (survey: RawSurvey, trustedCapabilities?: SurveyAssistantCapabilitySet) => SurveyAssistantResponseSlotTypes;
-declare const createSurveyAssistantEngineContext: (document: SurveyDocumentSnapshot, trustedCapabilities?: SurveyAssistantCapabilitySet, options?: CreateSurveyAssistantEngineContextOptions) => SurveyAssistantEngineContext;
-//#endregion
-//#region src/engine/expression-validation.d.ts
-type ResponseSlotTypeLookup = Record<string, ValueType | undefined>;
-declare const inferExpressionReturnType: (expression: JsonExpression | undefined, responseSlotTypes: ResponseSlotTypeLookup) => ValueType | undefined;
-declare const validateExpression: ({
-  expression,
-  expectedReturnType,
-  issues,
-  operationIndex,
-  responseSlotTypes,
-  scope
-}: {
-  expression: JsonExpression | undefined;
-  expectedReturnType?: ValueType;
-  issues: SurveyValidationIssue[];
-  operationIndex: number;
-  responseSlotTypes: ResponseSlotTypeLookup;
-  scope: string;
-}) => void;
-//#endregion
-//#region src/engine/expression-reference-integrity.d.ts
-declare const deriveSurveyExpressionResponseSlots: (survey: RawSurvey, trustedCapabilities?: SurveyAssistantCapabilitySet) => SurveyExpressionResponseSlot[];
-declare const analyzeSurveyAssistantExpressionReferences: (survey: RawSurvey, trustedCapabilities?: SurveyAssistantCapabilitySet) => SurveyExpressionReferenceDiagnostic[];
-declare const getSurveyAssistantExpressionDiagnosticGuidance: (diagnostic: Pick<SurveyExpressionReferenceDiagnostic, "category" | "disposition">) => string;
-//#endregion
-//#region src/engine/expression-mutations.d.ts
-declare const expressionSchema: z.ZodType<JsonExpression>;
-declare const expressionMutationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  kind: z.ZodLiteral<"set-item-display-condition">;
-  itemId: z.ZodString;
-  expression: z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-item-display-condition">;
-  itemId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"set-component-display-condition">;
-  itemId: z.ZodString;
-  componentId: z.ZodString;
-  expression: z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-component-display-condition">;
-  itemId: z.ZodString;
-  componentId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"set-component-disabled-condition">;
-  itemId: z.ZodString;
-  componentId: z.ZodString;
-  expression: z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-component-disabled-condition">;
-  itemId: z.ZodString;
-  componentId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"set-validation-expression">;
-  itemId: z.ZodString;
-  validationKey: z.ZodString;
-  expression: z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-validation-expression">;
-  itemId: z.ZodString;
-  validationKey: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"set-prefill">;
-  itemId: z.ZodString;
-  prefill: z.ZodObject<{
-    id: z.ZodString;
-    target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-      type: z.ZodLiteral<"itemResponse">;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"field">;
-      fieldId: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"embeddedField">;
-      optionId: z.ZodString;
-      fieldId: z.ZodString;
-    }, z.core.$strip>], "type">;
-    when: z.ZodOptional<z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>>;
-    apply: z.ZodOptional<z.ZodLiteral<"ifEmpty">>;
-    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
-      type: z.ZodLiteral<"static">;
-      value: z.ZodType<ResponseValue, unknown, z.core.$ZodTypeInternals<ResponseValue, unknown>>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"expression">;
-      expression: z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"templateValue">;
-      key: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-      type: z.ZodLiteral<"previousResponse">;
-      ref: z.ZodObject<{
-        surveyKey: z.ZodOptional<z.ZodString>;
-        itemId: z.ZodString;
-        target: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
-          type: z.ZodLiteral<"itemResponse">;
-        }, z.core.$strip>, z.ZodObject<{
-          type: z.ZodLiteral<"field">;
-          fieldId: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-          type: z.ZodLiteral<"embeddedField">;
-          optionId: z.ZodString;
-          fieldId: z.ZodString;
-        }, z.core.$strip>], "type">>;
-      }, z.core.$strip>;
-      ifUnsupported: z.ZodOptional<z.ZodLiteral<"skip">>;
-    }, z.core.$strip>], "type">;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-prefill">;
-  itemId: z.ZodString;
-  prefillId: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"set-template-value">;
-  templateKey: z.ZodString;
-  templateValue: z.ZodObject<{
-    type: z.ZodEnum<{
-      default: "default";
-      date2string: "date2string";
-    }>;
-    returnType: z.ZodEnum<{
-      string: "string";
-      number: "number";
-      boolean: "boolean";
-      date: "date";
-      reference: "reference";
-      duration: "duration";
-      "string[]": "string[]";
-      "duration[]": "duration[]";
-      "reference[]": "reference[]";
-      "number[]": "number[]";
-      "date[]": "date[]";
-    }>;
-    expression: z.ZodOptional<z.ZodType<JsonExpression, unknown, z.core.$ZodTypeInternals<JsonExpression, unknown>>>;
-    dateFormat: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  kind: z.ZodLiteral<"clear-template-value">;
-  templateKey: z.ZodString;
-}, z.core.$strip>], "kind">;
-type ExpressionMutation = z.infer<typeof expressionMutationSchema>;
-/** Compile an expression delta in order, without mutating the accepted turn draft.
- * Expression mutations cannot change item structure or response slots, so the
- * immutable indexes remain valid while each mutation reads the preceding result.
- * The caller validates and stages the complete delta atomically.
- */
-declare const buildExpressionMutationBatch: (mutations: ExpressionMutation[], snapshot: SurveyAssistantEngineContext) => {
-  issues: SurveyValidationIssue[];
-  patches: JsonPatchOperation[];
-};
-declare const buildExpressionMutationPatches: ({
-  mutation,
-  operationIndex,
-  issues,
-  patches,
-  responseSlotTypes,
-  snapshot
-}: {
-  mutation: ExpressionMutation;
-  operationIndex: number;
-  issues: SurveyValidationIssue[];
-  patches: JsonPatchOperation[];
-  responseSlotTypes: ResponseSlotTypeLookup;
-  snapshot: SurveyAssistantEngineContext;
-}) => void;
-//#endregion
-//#region src/engine/inspection.d.ts
-declare const DEFAULT_LIMIT = 12;
-declare const MAX_LIMIT = 50;
-declare const itemSummarySchema: z.ZodObject<{
-  itemId: z.ZodString;
-  itemType: z.ZodString;
-  key: z.ZodString;
-  fullKey: z.ZodString;
-  itemLabel: z.ZodOptional<z.ZodString>;
-  parentId: z.ZodOptional<z.ZodString>;
-  depth: z.ZodOptional<z.ZodNumber>;
-  childCount: z.ZodOptional<z.ZodNumber>;
-  path: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  siblingKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-type ItemSummary = z.infer<typeof itemSummarySchema>;
-declare const translationEntrySchema: z.ZodObject<{
-  locale: z.ZodString;
-  contentKey: z.ZodString;
-  text: z.ZodString;
-}, z.core.$strip>;
-type TranslationEntry = z.infer<typeof translationEntrySchema>;
-declare const choiceOptionDetailsSchema: z.ZodObject<{
-  position: z.ZodNumber;
-  id: z.ZodString;
-  key: z.ZodOptional<z.ZodString>;
-  labelContentKey: z.ZodString;
-  hasDisplayCondition: z.ZodOptional<z.ZodBoolean>;
-  embeddedFormItemId: z.ZodOptional<z.ZodString>;
-  embeddedFormFieldGroupCount: z.ZodOptional<z.ZodNumber>;
-  embeddedFormAuthoringMode: z.ZodOptional<z.ZodEnum<{
-    custom: "custom";
-    simple: "simple";
-  }>>;
-  embeddedFormSimpleModeValid: z.ZodOptional<z.ZodBoolean>;
-  embeddedFormTranslationPrefix: z.ZodOptional<z.ZodString>;
-  embeddedFormResponseSlotPrefix: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const formSelectOptionDetailsSchema: z.ZodObject<{
-  position: z.ZodNumber;
-  id: z.ZodString;
-  value: z.ZodOptional<z.ZodString>;
-  labelContentKey: z.ZodString;
-}, z.core.$strip>;
-declare const formFieldGroupLayoutSchema: z.ZodObject<{
-  base: z.ZodNumber;
-  xs: z.ZodNumber;
-  sm: z.ZodNumber;
-  md: z.ZodNumber;
-  xl: z.ZodNumber;
-}, z.core.$strip>;
-declare const formFieldDetailsSchema: z.ZodObject<{
-  position: z.ZodNumber;
-  id: z.ZodString;
-  key: z.ZodString;
-  type: z.ZodString;
-  responseSlotId: z.ZodString;
-  labelContentKey: z.ZodString;
-  descriptionContentKey: z.ZodString;
-  errorContentKey: z.ZodString;
-  placeholderContentKey: z.ZodOptional<z.ZodString>;
-  unitContentKey: z.ZodOptional<z.ZodString>;
-  checkedLabelContentKey: z.ZodOptional<z.ZodString>;
-  uncheckedLabelContentKey: z.ZodOptional<z.ZodString>;
-  required: z.ZodOptional<z.ZodBoolean>;
-  controllerType: z.ZodOptional<z.ZodString>;
-  validationTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  validationMessageContentKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  selectOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    position: z.ZodNumber;
-    id: z.ZodString;
-    value: z.ZodOptional<z.ZodString>;
-    labelContentKey: z.ZodString;
-  }, z.core.$strip>>>;
-}, z.core.$strip>;
-declare const formFieldGroupDetailsSchema: z.ZodObject<{
-  position: z.ZodNumber;
-  id: z.ZodString;
-  titleContentKey: z.ZodString;
-  descriptionContentKey: z.ZodString;
-  hasDisplayCondition: z.ZodOptional<z.ZodBoolean>;
-  layout: z.ZodObject<{
-    base: z.ZodNumber;
-    xs: z.ZodNumber;
-    sm: z.ZodNumber;
-    md: z.ZodNumber;
-    xl: z.ZodNumber;
-  }, z.core.$strip>;
-  fieldCount: z.ZodNumber;
-  fields: z.ZodArray<z.ZodObject<{
-    position: z.ZodNumber;
-    id: z.ZodString;
-    key: z.ZodString;
-    type: z.ZodString;
-    responseSlotId: z.ZodString;
-    labelContentKey: z.ZodString;
-    descriptionContentKey: z.ZodString;
-    errorContentKey: z.ZodString;
-    placeholderContentKey: z.ZodOptional<z.ZodString>;
-    unitContentKey: z.ZodOptional<z.ZodString>;
-    checkedLabelContentKey: z.ZodOptional<z.ZodString>;
-    uncheckedLabelContentKey: z.ZodOptional<z.ZodString>;
-    required: z.ZodOptional<z.ZodBoolean>;
-    controllerType: z.ZodOptional<z.ZodString>;
-    validationTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    validationMessageContentKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    selectOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      position: z.ZodNumber;
-      id: z.ZodString;
-      value: z.ZodOptional<z.ZodString>;
-      labelContentKey: z.ZodString;
-    }, z.core.$strip>>>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const itemConfigDetailsSchema: z.ZodObject<{
-  kind: z.ZodEnum<{
-    choice: "choice";
-    form: "form";
-    generic: "generic";
-  }>;
-  summary: z.ZodArray<z.ZodString>;
-  authoringMode: z.ZodOptional<z.ZodEnum<{
-    custom: "custom";
-    simple: "simple";
-  }>>;
-  simpleModeValid: z.ZodOptional<z.ZodBoolean>;
-  mainResponseSlotId: z.ZodOptional<z.ZodString>;
-  choiceOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    position: z.ZodNumber;
-    id: z.ZodString;
-    key: z.ZodOptional<z.ZodString>;
-    labelContentKey: z.ZodString;
-    hasDisplayCondition: z.ZodOptional<z.ZodBoolean>;
-    embeddedFormItemId: z.ZodOptional<z.ZodString>;
-    embeddedFormFieldGroupCount: z.ZodOptional<z.ZodNumber>;
-    embeddedFormAuthoringMode: z.ZodOptional<z.ZodEnum<{
-      custom: "custom";
-      simple: "simple";
-    }>>;
-    embeddedFormSimpleModeValid: z.ZodOptional<z.ZodBoolean>;
-    embeddedFormTranslationPrefix: z.ZodOptional<z.ZodString>;
-    embeddedFormResponseSlotPrefix: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
-  formFieldGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    position: z.ZodNumber;
-    id: z.ZodString;
-    titleContentKey: z.ZodString;
-    descriptionContentKey: z.ZodString;
-    hasDisplayCondition: z.ZodOptional<z.ZodBoolean>;
-    layout: z.ZodObject<{
-      base: z.ZodNumber;
-      xs: z.ZodNumber;
-      sm: z.ZodNumber;
-      md: z.ZodNumber;
-      xl: z.ZodNumber;
-    }, z.core.$strip>;
-    fieldCount: z.ZodNumber;
-    fields: z.ZodArray<z.ZodObject<{
-      position: z.ZodNumber;
-      id: z.ZodString;
-      key: z.ZodString;
-      type: z.ZodString;
-      responseSlotId: z.ZodString;
-      labelContentKey: z.ZodString;
-      descriptionContentKey: z.ZodString;
-      errorContentKey: z.ZodString;
-      placeholderContentKey: z.ZodOptional<z.ZodString>;
-      unitContentKey: z.ZodOptional<z.ZodString>;
-      checkedLabelContentKey: z.ZodOptional<z.ZodString>;
-      uncheckedLabelContentKey: z.ZodOptional<z.ZodString>;
-      required: z.ZodOptional<z.ZodBoolean>;
-      controllerType: z.ZodOptional<z.ZodString>;
-      validationTypes: z.ZodOptional<z.ZodArray<z.ZodString>>;
-      validationMessageContentKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
-      selectOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        position: z.ZodNumber;
-        id: z.ZodString;
-        value: z.ZodOptional<z.ZodString>;
-        labelContentKey: z.ZodString;
-      }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>>;
-  listOrdering: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-type ChoiceOptionDetails = z.infer<typeof choiceOptionDetailsSchema>;
-type FormFieldDetails = z.infer<typeof formFieldDetailsSchema>;
-type FormFieldGroupDetails = z.infer<typeof formFieldGroupDetailsSchema>;
-type ItemConfigDetails = z.infer<typeof itemConfigDetailsSchema>;
-type SurveyInspectionIndex = SurveyAssistantEngineContext["inspection"];
-type SurveyOutlineNode = SurveyInspectionIndex["outline"][number];
-type SurveyKeyIndexEntry = SurveyInspectionIndex["keyIndex"][number];
-type SurveyFocusItemNode = NonNullable<SurveyInspectionIndex["focusItem"]>;
-declare const normalizeText: (value: string | undefined) => string;
-declare const clampLimit: (limit: number | undefined) => number;
-declare const parseCursor: (cursor: string | undefined) => number;
-declare const unique: <T>(values: T[]) => T[];
-declare const sliceWithCursor: <T>(values: T[], input: {
-  cursor?: string;
-  limit?: number;
-}) => {
-  items: T[];
-  nextCursor: string | undefined;
-  truncated: boolean;
-};
-declare const mapOutlineById: (snapshot: SurveyAssistantEngineContext) => Map<string, SurveyAssistantInspectionOutlineNode>;
-declare const mapKeyIndexById: (snapshot: SurveyAssistantEngineContext) => Map<string, SurveyAssistantInspectionKeyEntry>;
-/** The full-survey key index, regardless of the (possibly focus-scoped) outline. */
-declare const getKeyIndexEntries: (snapshot: SurveyAssistantEngineContext) => SurveyKeyIndexEntry[];
-declare const getRawSurvey: (snapshot: SurveyAssistantEngineContext) => Partial<RawSurvey>;
-declare const getRawSurveyItems: (snapshot: SurveyAssistantEngineContext) => RawSurveyItem[];
-declare const mapRawItemsById: (snapshot: SurveyAssistantEngineContext) => Map<string, RawSurveyItem>;
-declare const buildSurveyTranslations: (snapshot: SurveyAssistantEngineContext) => SurveyTranslations;
-declare const summarizeRawItem: (item: RawSurveyItem) => ItemSummary;
-declare const buildItemTranslationEntries: (snapshot: SurveyAssistantEngineContext, itemId: string, input: {
-  locales?: string[];
-  textLimit?: number;
-}) => TranslationEntry[];
-declare const summarizeOutlineNode: (node: SurveyOutlineNode) => ItemSummary;
-declare const summarizeKeyIndexEntry: (entry: SurveyKeyIndexEntry, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary;
-declare const summarizeKeyIndexEntries: (entries: SurveyKeyIndexEntry[], outlineById: Map<string, SurveyOutlineNode>) => ItemSummary[];
-declare const buildItemConfigDetails: (rawItem: RawSurveyItem) => ItemConfigDetails | undefined;
-declare const buildEmbeddedFormDetails: (choiceOption: ChoiceOptionDetails, embeddedForm: unknown) => ItemConfigDetails | undefined;
-declare const buildConfigSearchText: (rawItem: RawSurveyItem) => string[];
-declare const summarizeFocusItemNode: (node: SurveyFocusItemNode, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary;
-declare const summarizeItemById: (itemId: string, indexById: Map<string, SurveyKeyIndexEntry>, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary | undefined;
-/**
- * Resolve an item by internal itemId, or fall back to matching on `key` /
- * `fullKey`. Model-facing text (outline rows, fullKey paths) only ever shows
- * key/fullKey, not the internal itemId, so models often pass a key like
- * "info_1" where an itemId is expected — this keeps that usage working.
- */
-declare const resolveItemSummary: (identifier: string, indexById: Map<string, SurveyKeyIndexEntry>, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary | undefined;
-declare const itemMatchesQuery: (item: ItemSummary, query: string) => boolean;
-/**
- * Direct children of `parentFullKey` derived from the full-survey key index.
- * This works for any item, selected or not.
- */
-declare const findDirectChildrenByFullKey: (entries: SurveyKeyIndexEntry[], outlineById: Map<string, SurveyOutlineNode>, parentFullKey: string) => ItemSummary[];
-//#endregion
-//#region src/engine/normalization.d.ts
-type SurveyChangeNormalizationIssue = {
-  path: string;
-  message: string;
-};
-/**
- * Accepts common model-authored shorthand and converts it to the strict
- * assistant operation shape before validation. This keeps the public tool
- * compact while making it tolerant of predictable schema-near authoring
- * mistakes: nested raw translation maps, sibling config objects, choice
- * optionId aliases, flat form fields, and compact rich-text blocks.
- */
-declare const normalizeSurveyChangeOperations: (operations: unknown[], defaultLocale: string) => {
-  operations: unknown[];
-  issues: SurveyChangeNormalizationIssue[];
-};
-//#endregion
-//#region src/engine/operation-execution.d.ts
-/**
- * Canonical pure executor for already-normalized, validated survey operation
- * semantics. Raw-draft simulation uses the returned survey directly; editor
- * adapters use it to decide domain results before recording them through the
- * editor's normal mutation and history APIs.
- */
-declare const executeSurveyOperationsOnRawSurvey: ({
-  operations,
-  survey
-}: {
-  operations: SurveyOperation[];
-  survey: RawSurvey;
-}) => RawSurvey;
-/** @deprecated Prefer `executeSurveyOperationsOnRawSurvey` for new integrations. */
-declare const applyValidatedSurveyOperationsToDraft: ({
-  operations,
-  survey
-}: {
-  operations: SurveyOperation[];
-  survey: RawSurvey;
-}) => RawSurvey;
-//#endregion
-//#region src/engine/operations.d.ts
-declare const MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL = 200;
-declare const MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT = 1000;
-declare const buildSurveyDocumentVersion: (snapshot: SurveyAssistantEngineContext | SurveyDocumentSnapshot) => SurveyDocumentVersion;
-declare const validateSurveyOperations: ({
-  allowExpressionJsonPatches,
-  maxOperations,
-  operations,
-  snapshot: snapshotInput
-}: {
-  allowExpressionJsonPatches?: boolean;
-  maxOperations?: number;
-  operations: SurveyOperation[];
-  snapshot: SurveyAssistantEngineContext | SurveyDocumentSnapshot | undefined;
-}) => SurveyValidationResult;
-declare const createSurveyChangeSet: ({
-  allowExpressionJsonPatches,
-  maxOperations,
-  operations,
-  snapshot,
-  summary,
-  turnId
-}: {
-  allowExpressionJsonPatches?: boolean;
-  maxOperations?: number;
-  operations: SurveyOperation[];
-  snapshot: SurveyAssistantEngineContext | SurveyDocumentSnapshot | undefined;
-  summary: string;
-  turnId: string;
-}) => SurveyChangeSet;
-//#endregion
-//#region src/engine/mutation-recovery.d.ts
-type RecoveryTargetRefinement = {
-  targets: string[];
-  replacement: string;
-};
-//#endregion
-//#region src/engine/turn-survey-draft.d.ts
-declare const mutationRecoveryRouteByIssueCode: {
-  readonly "expression-patch-requires-specialized-tool": "expression";
-};
-type SurveyAssistantMutationRoute = (typeof mutationRecoveryRouteByIssueCode)[keyof typeof mutationRecoveryRouteByIssueCode];
-/**
- * Request-scoped transactional draft for one assistant response.
- *
- * Mutation tools submit deltas. A successful delta replaces the previous
- * candidate with a newly validated, cumulative change set. A rejected delta
- * leaves the accepted draft intact and blocks authorization until all of its
- * operation/surface obligations have been repaired. Only the latest cumulative
- * candidate can be authorized.
- */
-declare class TurnSurveyDraft {
-  #private;
-  readonly turnId: string;
-  constructor(turnId?: `${string}-${string}-${string}-${string}-${string}`);
-  initialize(context: SurveyAssistantEngineContext): void;
-  stage({
-    addressedTargets,
-    allowExpressionJsonPatches,
-    handledMutationRoutes,
-    retryOfChangeIds,
-    operations,
-    snapshot,
-    summary
-  }: {
-    addressedTargets?: string[];
-    allowExpressionJsonPatches?: boolean;
-    handledMutationRoutes?: SurveyAssistantMutationRoute[];
-    retryOfChangeIds?: string[];
-    operations: SurveyOperation[];
-    snapshot: SurveyAssistantEngineContext | SurveyDocumentSnapshot | undefined;
-    summary: string;
-  }): SurveyChangeSet;
-  reject(candidate: SurveyChangeSet, addressedTargets?: Iterable<string>, refinements?: RecoveryTargetRefinement[]): SurveyChangeSet;
-  finalize(status: SurveyAssistantTurnFinal["status"], createdAt?: string, details?: Pick<SurveyAssistantTurnFinal, "durationMs" | "startedAt" | "terminationReason">): SurveyAssistantTurnFinal;
-  getCandidate(changeSetId: string): SurveyChangeSet | undefined;
-  get draftOperations(): readonly SurveyOperation[];
-  get context(): SurveyAssistantEngineContext | undefined;
-  get final(): SurveyAssistantTurnFinal | null;
-}
-//#endregion
-//#region src/engine/task-context.d.ts
-type SurveyAssistantTaskPurpose = "suggest-item-key" | "suggest-item-label" | "translate-content";
-interface BuildSurveyAssistantTaskContextOptions {
-  purpose: SurveyAssistantTaskPurpose;
-  focusItemId?: string;
-  sourceLocale?: string;
-  targetLocales?: readonly string[];
-  sourceTexts?: readonly string[];
-}
-declare const buildSurveyAssistantTaskContext: (snapshot: SurveyDocumentSnapshot, options: BuildSurveyAssistantTaskContextOptions) => SurveyAssistantTaskContext;
-//#endregion
-//#region src/engine/task-result-cache.d.ts
-interface SurveyAssistantTaskResultCacheOptions {
-  ttlMs?: number;
-  maxEntries?: number;
-  now?: () => number;
-}
-/** Small in-memory LRU cache for deterministic, snapshot-scoped one-shot results. */
-declare class SurveyAssistantTaskResultCache {
-  private readonly entries;
-  private readonly ttlMs;
-  private readonly maxEntries;
-  private readonly now;
-  constructor(options?: SurveyAssistantTaskResultCacheOptions);
-  get<TResult>(key: string): TResult | undefined;
-  set<TResult>(key: string, value: TResult): void;
-  clear(): void;
-}
-//#endregion
-//#region src/engine/audit.d.ts
-type SurveyAuditSeverity = "error" | "warning" | "info";
-type SurveyAuditCategory = "structure" | "content" | "localization" | "logic" | "responses" | "assets" | "quality";
-interface SurveyAuditFinding {
-  code: string;
-  severity: SurveyAuditSeverity;
-  category: SurveyAuditCategory;
-  message: string;
-  itemId?: string;
-  locale?: string;
-  contentKey?: string;
-  suggestion?: string;
-}
-interface SurveyQualityReviewPrinciple {
-  id: string;
-  title: string;
-  prompt: string;
-}
-interface SurveyAuditKeyReviewEntry {
-  kind: "item" | "choice-option" | "form-field";
-  itemId: string;
-  itemKey: string;
-  key: string;
-  keySource: "explicit" | "fallback-id";
-  contentKey?: string;
-  content?: string;
-}
-interface SurveyAuditReport {
-  summary: Record<SurveyAuditSeverity, number> & {
-    total: number;
-  };
-  findingCount: number;
-  truncated: boolean;
-  metrics: {
-    itemCount: number;
-    localeCount: number;
-    responseSlotCount: number;
-    assetCount: number;
-    itemTypes: Record<string, number>;
-  };
-  findings: SurveyAuditFinding[];
-  qualityReviewPrinciples: SurveyQualityReviewPrinciple[];
-  keyReview: {
-    sourceLocale?: string;
-    entryCount: number;
-    offset: number;
-    returnedEntryCount: number;
-    truncated: boolean;
-    entries: SurveyAuditKeyReviewEntry[];
-    note: string;
-  };
-  note: string;
-}
-declare const auditSurvey: (context: SurveyAssistantEngineContext, options?: {
-  sourceLocale?: string;
-  targetLocales?: string[];
-  maxFindings?: number;
-  keyReviewOffset?: number;
-  keyReviewLimit?: number;
-}) => SurveyAuditReport;
-//#endregion
-export { formSelectOptionDetailsSchema as $, resolveAssistantCapabilityReference as $t, ChoiceOptionDetails as A, inferExpressionReturnType as At, SurveyOutlineNode as B, createSurveyAssistantEngineContext as Bt, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT as C, buildExpressionMutationPatches as Ct, applyValidatedSurveyOperationsToDraft as D, deriveSurveyExpressionResponseSlots as Dt, validateSurveyOperations as E, analyzeSurveyAssistantExpressionReferences as Et, ItemSummary as F, SurveyAssistantInspectionIndex as Ft, buildItemTranslationEntries as G, AssistantItemInspection as Gt, buildConfigSearchText as H, AssistantCapabilityReference as Ht, MAX_LIMIT as I, SurveyAssistantInspectionItemNode as It, clampLimit as J, assertSurveyAssistantCapabilities as Jt, buildSurveyTranslations as K, SurveyAssistantCapabilityMismatchError as Kt, SurveyFocusItemNode as L, SurveyAssistantInspectionKeyEntry as Lt, FormFieldDetails as M, CreateSurveyAssistantEngineContextOptions as Mt, FormFieldGroupDetails as N, SurveyAssistantEngineContext as Nt, executeSurveyOperationsOnRawSurvey as O, getSurveyAssistantExpressionDiagnosticGuidance as Ot, ItemConfigDetails as P, SurveyAssistantInspectionFocus as Pt, formFieldGroupLayoutSchema as Q, inspectAssistantItem as Qt, SurveyInspectionIndex as R, SurveyAssistantInspectionOutlineNode as Rt, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as S, buildExpressionMutationBatch as St, createSurveyChangeSet as T, expressionSchema as Tt, buildEmbeddedFormDetails as U, AssistantItemCapabilityAdapter as Ut, TranslationEntry as V, deriveResponseSlotTypes as Vt, buildItemConfigDetails as W, AssistantItemCreationResolution as Wt, formFieldDetailsSchema as X, createUnsupportedItemCapability as Xt, findDirectChildrenByFullKey as Y, createSurveyAssistantCapabilities as Yt, formFieldGroupDetailsSchema as Z, getDeterministicCreateItemTypes as Zt, BuildSurveyAssistantTaskContextOptions as _, summarizeOutlineNode as _t, isValidSimpleFormConfig$1 as a, itemSummarySchema as at, SurveyAssistantMutationRoute as b, unique as bt, SurveyAuditCategory as c, mapRawItemsById as ct, SurveyAuditReport as d, resolveItemSummary as dt, resolveAssistantItemCreation as en, getKeyIndexEntries as et, SurveyAuditSeverity as f, sliceWithCursor as ft, SurveyAssistantTaskResultCacheOptions as g, summarizeKeyIndexEntry as gt, SurveyAssistantTaskResultCache as h, summarizeKeyIndexEntries as ht, isCompatibleSimpleFieldUpsert$1 as i, itemMatchesQuery as it, DEFAULT_LIMIT as j, validateExpression as jt, normalizeSurveyChangeOperations as k, ResponseSlotTypeLookup as kt, SurveyAuditFinding as l, normalizeText as lt, auditSurvey as m, summarizeItemById as mt, getFormAuthoringMode$1 as n, getRawSurveyItems as nt, normalizeFormAuthoringConfig$1 as o, mapKeyIndexById as ot, SurveyQualityReviewPrinciple as p, summarizeFocusItemNode as pt, choiceOptionDetailsSchema as q, SurveyAssistantCapabilitySet as qt, hasSingleFormField as r, itemConfigDetailsSchema as rt, transitionFormAuthoringMode$1 as s, mapOutlineById as st, FormAuthoringMode as t, getRawSurvey as tt, SurveyAuditKeyReviewEntry as u, parseCursor as ut, SurveyAssistantTaskPurpose as v, summarizeRawItem as vt, buildSurveyDocumentVersion as w, expressionMutationSchema as wt, TurnSurveyDraft as x, ExpressionMutation as xt, buildSurveyAssistantTaskContext as y, translationEntrySchema as yt, SurveyKeyIndexEntry as z, SurveyAssistantResponseSlotTypes as zt };
-//# sourceMappingURL=index-Tnqv-yKW.d.mts.map