@case-framework/survey-assistant 0.8.0 → 0.9.0

package/dist/index-Ciq7vHIs.d.mts

@@ -1,716 +0,0 @@
-import { i as AssistantItemTypeManifest, o as SurveyAssistantCapabilityManifest } from "./capabilities-CmeeAjEc.mjs";
-import "./digest-C39WyAWG.mjs";
-import { h as SurveyAssistantTaskContext } from "./index-D7wT6P3t.mjs";
-import { F as SurveyValidationIssue, I as SurveyValidationResult, Mt as JsonValue$1, N as SurveyOperation, St as SurveyDocumentVersion, f as SurveyAssistantTurnFinal, h as SurveyChangeSet, xt as SurveyDocumentSnapshot } from "./lifecycle-Dm8u7QFh.mjs";
-import { z } from "zod";
-import { Content, ItemTypeRegistry, JsonExpression, JsonPatchOperation, RawSurvey, RawSurveyItem, ResponseSlotDefinition, 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;
-  /** Trusted server-safe core shared with the player, including response activation dependencies. */
-  itemCore?: ItemTypeRegistry[string];
-  references?: AssistantCapabilityReference[];
-  configurationSchema?: z.ZodType;
-  materializePreset?: (presetId: string, locale: string) => {
-    config: RawSurveyItem["config"];
-    translations: NonNullable<Extract<SurveyOperation, {
-      kind: "create-item";
-    }>["translations"]>;
-  };
-  validContentKeys?: (item: RawSurveyItem) => string[];
-  normalizeCreate?: (item: RawSurveyItem) => RawSurveyItem;
-  requiredCreateContentKeys?: (item: RawSurveyItem) => string[];
-  validateItem?: (item: RawSurveyItem) => SurveyValidationIssue[];
-  supportsOperation?: (operation: SurveyOperation) => boolean;
-  deriveResponseSlotDefinitions?: (item: RawSurveyItem) => ResponseSlotDefinition[];
-  /** Type-only inspection adapter. Creatable response items require full definitions. */
-  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;
-declare const createSurveyAssistantCapabilities: (capabilities: readonly AssistantItemCapabilityAdapter[]) => SurveyAssistantCapabilitySet;
-declare const getDeterministicCreateItemTypes: (manifest: SurveyAssistantCapabilityManifest) => string[];
-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;
-  editorName: string;
-  breadcrumb: string;
-  itemLabel?: string;
-  childCount: number;
-}
-interface SurveyAssistantInspectionFocus {
-  focusItemId: string;
-  parentItemId?: string;
-  pathItemIds: string[];
-  siblingItemIds: string[];
-  childItemIds: string[];
-}
-interface SurveyAssistantInspectionItemNode {
-  itemId: string;
-  itemType: string;
-  editorName: string;
-  breadcrumb: string;
-  itemLabel?: string;
-  siblingNames: string[];
-  translations: Array<{
-    locale: string;
-    contentKey: string;
-    text: string;
-  }>;
-  descendants: SurveyAssistantInspectionItemNode[];
-}
-interface SurveyAssistantInspectionItemEntry {
-  itemId: string;
-  itemType: string;
-  editorName: string;
-  breadcrumb: 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;
-  itemIndex: SurveyAssistantInspectionItemEntry[];
-  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;
-  responseVariables: import("@case-framework/survey-core").OwnedResponseSlotDefinition[];
-  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;
-  editorName: z.ZodString;
-  breadcrumb: 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>>;
-  siblingNames: 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;
-  code: 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>;
-}, z.core.$strip>;
-declare const formSelectOptionDetailsSchema: z.ZodObject<{
-  position: z.ZodNumber;
-  id: z.ZodString;
-  code: 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;
-  variableName: 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;
-    code: 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;
-    variableName: 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;
-      code: z.ZodOptional<z.ZodString>;
-      labelContentKey: z.ZodString;
-    }, z.core.$strip>>>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const itemConfigDetailsSchema: z.ZodObject<{
-  kind: z.ZodEnum<{
-    form: "form";
-    choice: "choice";
-    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;
-    code: 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>;
-  }, 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;
-      variableName: 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;
-        code: 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 SurveyItemIndexEntry = SurveyInspectionIndex["itemIndex"][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 mapItemIndexById: (snapshot: SurveyAssistantEngineContext) => Map<string, SurveyAssistantInspectionItemEntry>;
-/** The full-survey item index, regardless of the (possibly focus-scoped) outline. */
-declare const getItemIndexEntries: (snapshot: SurveyAssistantEngineContext) => SurveyItemIndexEntry[];
-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 summarizeItemIndexEntry: (entry: SurveyItemIndexEntry, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary;
-declare const summarizeItemIndexEntries: (entries: SurveyItemIndexEntry[], 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, SurveyItemIndexEntry>, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary | undefined;
-/** Resolve only persistent item IDs. Search can discover names and breadcrumbs. */
-declare const resolveItemSummary: (identifier: string, indexById: Map<string, SurveyItemIndexEntry>, outlineById: Map<string, SurveyOutlineNode>) => ItemSummary | undefined;
-declare const itemMatchesQuery: (item: ItemSummary, query: string) => boolean;
-/**
- * Direct children of `parentId` derived from the full-survey item index.
- * This works for any item, selected or not.
- */
-declare const findDirectChildrenByParentId: (entries: SurveyItemIndexEntry[], outlineById: Map<string, SurveyOutlineNode>, parentId: 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, capabilities }: {
-  operations: SurveyOperation[];
-  survey: RawSurvey;
-  capabilities?: SurveyAssistantCapabilitySet;
-}) => 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 validateSurveyTreeStructure: (survey: RawSurvey, operationId?: string, availableItemTypes?: ReadonlySet<string>) => SurveyValidationIssue[];
-/** Preserve existing defects without accepting changed or additional violations. */
-declare const findIntroducedSurveyStructureIssues: ({ before, after }: {
-  before: readonly SurveyValidationIssue[];
-  after: readonly SurveyValidationIssue[];
-}) => SurveyValidationIssue[];
-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);
-  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-response-name" | "suggest-response-settings" | "suggest-item-label" | "translate-content";
-interface BuildSurveyAssistantTaskContextOptions {
-  purpose: SurveyAssistantTaskPurpose;
-  capabilities?: SurveyAssistantCapabilitySet;
-  focusItemId?: string;
-  focusSlotId?: string;
-  slotIds?: readonly 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: "response-variable" | "choice-option";
-  slotId: string;
-  valueType?: string;
-  computed?: boolean;
-  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 { formFieldGroupLayoutSchema as $, resolveAssistantCapabilityReference as $t, normalizeSurveyChangeOperations as A, ResponseSlotTypeLookup as At, SurveyItemIndexEntry as B, SurveyAssistantResponseSlotTypes as Bt, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_TURN_DRAFT as C, buildExpressionMutationBatch as Ct, validateSurveyOperations as D, analyzeSurveyAssistantExpressionReferences as Dt, findIntroducedSurveyStructureIssues as E, expressionSchema as Et, ItemConfigDetails as F, SurveyAssistantInspectionFocus as Ft, buildItemConfigDetails as G, AssistantItemInspection as Gt, TranslationEntry as H, deriveResponseSlotTypes as Ht, ItemSummary as I, SurveyAssistantInspectionIndex as It, choiceOptionDetailsSchema as J, assertSurveyAssistantCapabilities as Jt, buildItemTranslationEntries as K, SurveyAssistantCapabilityMismatchError as Kt, MAX_LIMIT as L, SurveyAssistantInspectionItemEntry as Lt, DEFAULT_LIMIT as M, validateExpression as Mt, FormFieldDetails as N, CreateSurveyAssistantEngineContextOptions as Nt, validateSurveyTreeStructure as O, deriveSurveyExpressionResponseSlots as Ot, FormFieldGroupDetails as P, SurveyAssistantEngineContext as Pt, formFieldGroupDetailsSchema as Q, inspectAssistantItem as Qt, SurveyFocusItemNode as R, SurveyAssistantInspectionItemNode as Rt, MAX_SURVEY_ASSISTANT_OPERATIONS_PER_PROPOSAL as S, ExpressionMutation as St, createSurveyChangeSet as T, expressionMutationSchema as Tt, buildConfigSearchText as U, AssistantCapabilityReference as Ut, SurveyOutlineNode as V, createSurveyAssistantEngineContext as Vt, buildEmbeddedFormDetails as W, AssistantItemCapabilityAdapter as Wt, findDirectChildrenByParentId as X, createUnsupportedItemCapability as Xt, clampLimit as Y, createSurveyAssistantCapabilities as Yt, formFieldDetailsSchema as Z, getDeterministicCreateItemTypes as Zt, BuildSurveyAssistantTaskContextOptions as _, summarizeItemIndexEntry as _t, isValidSimpleFormConfig$1 as a, itemMatchesQuery as at, SurveyAssistantMutationRoute as b, translationEntrySchema as bt, SurveyAuditCategory as c, mapOutlineById as ct, SurveyAuditReport as d, parseCursor as dt, formSelectOptionDetailsSchema as et, SurveyAuditSeverity as f, resolveItemSummary as ft, SurveyAssistantTaskResultCacheOptions as g, summarizeItemIndexEntries as gt, SurveyAssistantTaskResultCache as h, summarizeItemById as ht, isCompatibleSimpleFieldUpsert$1 as i, itemConfigDetailsSchema as it, ChoiceOptionDetails as j, inferExpressionReturnType as jt, executeSurveyOperationsOnRawSurvey as k, getSurveyAssistantExpressionDiagnosticGuidance as kt, SurveyAuditFinding as l, mapRawItemsById as lt, auditSurvey as m, summarizeFocusItemNode as mt, getFormAuthoringMode$1 as n, getRawSurvey as nt, normalizeFormAuthoringConfig$1 as o, itemSummarySchema as ot, SurveyQualityReviewPrinciple as p, sliceWithCursor as pt, buildSurveyTranslations as q, SurveyAssistantCapabilitySet as qt, hasSingleFormField as r, getRawSurveyItems as rt, transitionFormAuthoringMode$1 as s, mapItemIndexById as st, FormAuthoringMode as t, getItemIndexEntries as tt, SurveyAuditKeyReviewEntry as u, normalizeText as ut, SurveyAssistantTaskPurpose as v, summarizeOutlineNode as vt, buildSurveyDocumentVersion as w, buildExpressionMutationPatches as wt, TurnSurveyDraft as x, unique as xt, buildSurveyAssistantTaskContext as y, summarizeRawItem as yt, SurveyInspectionIndex as z, SurveyAssistantInspectionOutlineNode as zt };
-//# sourceMappingURL=index-Ciq7vHIs.d.mts.map