@intellectif/lk-core 0.19.0 → 0.20.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z a
 export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.cjs';
 import { ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.cjs';
 export { AssessmentSectionInput, Band, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, GradeReadAloudOptions, PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudWordAlignment, ReadAloudWordState, RoundingMode, SPEECH_ASSESSMENT_MAX_WORDS, ScoringOptions, SectionScore, SpeechAssessment, SpeechMeasurement, SpeechPhoneme, SpeechPhonemeCandidate, SpeechPlausibilityPolicy, SpeechSyllable, SpeechUnscorable, SpeechUnscorableCode, SpeechWord, SpeechWordError, WavInspection, WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment } from './scoring.cjs';
-import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-bpuDhvXV.cjs';
-export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, k as MediaTimeline, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-bpuDhvXV.cjs';
+import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-7S3-TLjT.cjs';
+export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, k as MediaTimeline, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-7S3-TLjT.cjs';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.cjs';
 
@@ -128,6 +128,80 @@ declare function checkAiHint(raw: unknown, request: AiHintRequest): {
  */
 declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
 
+/**
+ * How a paper is delivered: what a learner is shown around the questions, as
+ * the school running it decides — separately from the content, so that one
+ * item serves a practice lesson and a final exam without being authored twice.
+ *
+ * Every setting is a RESTRICTION on what the SDK does by default, and every
+ * one defaults to `true`: an empty policy is exactly the behaviour there was
+ * before policies existed. A policy can take something away; it can never make
+ * a mode show what that mode cannot — no policy makes an `exam` reveal a grade,
+ * because the client in an exam has no answer key to grade with.
+ */
+interface DeliveryPolicy {
+    /**
+     * Whether a graded answer shows as graded: right and wrong marks, the score,
+     * and the author's feedback. `false` leaves the learner with "Answer
+     * submitted." — a homework quiz marked on the client and shown to the
+     * learner at the end, or a review that shows what was answered and not how
+     * it was marked. Never on in `exam`.
+     */
+    feedback?: boolean | null;
+    /**
+     * Whether the right answer is shown beside a wrong one, wherever an activity
+     * would show it: the correct option of a multiple-choice question, the
+     * correct answers `showCorrectAnswers` puts in the blanks, a dictation's
+     * transcript. `false` still marks what the learner answered right or wrong.
+     * Use it on a paper that will be sat again, or before a retry.
+     */
+    solutions?: boolean | null;
+    /**
+     * Whether the learner can ask for hints: the author's hints on a
+     * fill-in-the-blanks blank, a dictation's word hints, and AI hints. `false`
+     * switches every kind off.
+     *
+     * **The author's fill-in-the-blanks hints are on in `exam` unless this says
+     * otherwise** — they are public content, and were designed to be. Set
+     * `hints: false` on a paper of record whose hints are not part of the test.
+     */
+    hints?: boolean | null;
+    /**
+     * The deployment's switches for AI help, beside the author's switch on the
+     * item and the ports the host supplies: a feature appears only where all
+     * three allow it. `false` switches a feature off; nothing here can switch one
+     * on, and nothing switches AI help on in an `exam`.
+     *
+     * `ai: false` switches both off and `ai: true` leaves both as the other
+     * settings allow — the same as leaving `ai` out.
+     */
+    ai?: boolean | {
+        hints?: boolean | null;
+        explanations?: boolean | null;
+    } | null;
+}
+/**
+ * A policy with every setting spelled out: what {@link resolveDeliveryPolicy}
+ * returns, and what an attempt plan records, so the record of the conditions
+ * a learner sat a paper under never depends on a default that may one day
+ * change.
+ */
+interface ResolvedDeliveryPolicy {
+    feedback: boolean;
+    solutions: boolean;
+    hints: boolean;
+    ai: {
+        hints: boolean;
+        explanations: boolean;
+    };
+}
+/** One thing {@link validateDeliveryPolicy} found wrong with a policy. */
+interface DeliveryPolicyIssue {
+    /** Where, as a dotted path: `hints`, `ai.explanations`, or `''` for the policy itself. */
+    path: string;
+    message: string;
+}
+
 /**
  * The frozen record of what one attempt was served.
  *
@@ -140,6 +214,7 @@ declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
  *
  * This is the thing you persist next to the responses.
  */
+
 /** One planned position: an item, its identity, its worth, and its fingerprint. */
 interface AttemptPlanSlot {
     /**
@@ -227,6 +302,12 @@ interface AttemptPlan {
      * later; the per-slot hashes then say WHICH item moved.
      */
     planHash: string;
+    /**
+     * The delivery policy the attempt was sat under, every setting spelled out:
+     * whether feedback, solutions and hints showed, and which AI help was on.
+     * Absent when `planAttempt` was given none. Part of `planHash` when present.
+     */
+    delivery?: ResolvedDeliveryPolicy;
     slots: AttemptPlanSlot[];
     /** Sum of every slot's `points`, frozen. The denominator of the paper. */
     totalPoints: number;
@@ -257,6 +338,16 @@ interface AttemptPlanDrift {
     changedPointsSlotIds: string[];
     /** Slots presented at a different position now than they were then. */
     reorderedSlotIds: string[];
+    /**
+     * The delivery policy differs: one plan records a policy the other does not,
+     * or a setting differs. Not a change to any question, but a change to the
+     * conditions it was asked under — hints on in one, off in the other — so it
+     * breaks `matches` like any other difference.
+     *
+     * Present only when it is `true`, so a report between two plans without a
+     * policy has exactly the shape it had before policies existed.
+     */
+    deliveryChanged?: true;
 }
 
 /** Options for {@link planAttempt}. */
@@ -281,6 +372,20 @@ interface PlanAttemptOptions<TItem> {
      *         number — a slot worth `NaN` points would poison the whole total.
      */
     points?: (slot: SequenceSlot<TItem>) => number;
+    /**
+     * The delivery policy this attempt is sat under — whether hints were
+     * offered, whether AI help was, whether feedback and solutions showed.
+     * Frozen into the plan with every setting spelled out, so the record of the
+     * conditions a grade was earned under does not depend on today's defaults.
+     *
+     * Recorded only when given: a plan made without one is byte-identical to a
+     * plan made before policies existed, `planHash` included.
+     *
+     * @throws Error when the policy does not pass `validateDeliveryPolicy` —
+     *         a misspelled restriction is no restriction, and a plan is the
+     *         record an appeal reads.
+     */
+    delivery?: DeliveryPolicy | null;
 }
 /**
  * Freezes what an attempt is being served: the presented order, each slot's
@@ -676,6 +781,45 @@ declare function contentHash(value: unknown): string;
  */
 declare function countWords(text: string): number;
 
+/**
+ * The policy that restricts nothing: every setting `true`. It is what an absent
+ * policy resolves to, and it is exactly the behaviour the SDK had before
+ * delivery policies existed.
+ */
+declare const OPEN_DELIVERY_POLICY: ResolvedDeliveryPolicy;
+/**
+ * A policy with every setting spelled out — see {@link DeliveryPolicy}.
+ *
+ * Tolerant, because it runs where a learner is waiting: nothing here throws.
+ * A value it cannot read restricts rather than allows (see above), and a
+ * policy that is not an object at all restricts everything. Check a policy
+ * before you store it with {@link validateDeliveryPolicy}; `planAttempt` does.
+ */
+declare function resolveDeliveryPolicy(policy: unknown): ResolvedDeliveryPolicy;
+/**
+ * The strictest of several policies: a setting is on only where every one of
+ * them leaves it on. How a course's policy and an assessment's combine, and
+ * how a pager's policy wins over whatever a question it draws was handed.
+ */
+declare function combineDeliveryPolicies(...policies: unknown[]): ResolvedDeliveryPolicy;
+/**
+ * Checks a policy before it is stored: each setting `true`, `false`, `null`
+ * or absent, and nothing else — no misspelled setting, no string standing in
+ * for a boolean.
+ *
+ * Stricter than {@link resolveDeliveryPolicy} on purpose. A misspelled
+ * restriction (`hint: false`) is silently no restriction at all, and a
+ * policy is a record of the conditions a paper was sat under: it is worth
+ * refusing before it is written down, rather than read charitably after.
+ */
+declare function validateDeliveryPolicy(policy: unknown): {
+    success: true;
+    data: DeliveryPolicy;
+} | {
+    success: false;
+    issues: DeliveryPolicyIssue[];
+};
+
 /** Thrown when activity data fails schema validation at a component boundary. */
 declare class ActivitySchemaError extends Error {
     readonly activityType: string;
@@ -1468,4 +1612,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import { v as AiSupportedActivityType, g as AiActivityInput, k as AiFeature, Z a
 export { A as ActivityAiPermissions, c as ActivityFeedback, e as ActivityResult, h as AiBlankFact, i as AiDictationFacts, l as AiFillInTheBlanksFacts, m as AiGapFact, n as AiGapSelectFacts, r as AiMultipleChoiceFacts, s as AiOptionFact, t as AiProvenance, x as AiVerdict, y as AiWordFact, B as BlankConfig, D as DeferredReason, F as DictationEquivalence, H as DictationSlowMedia, I as DictationTolerance, L as GapSelectBank, M as GapSelectChoice, O as GapSelectGap, R as Grader, S as GraderKind, T as GraderUsage, U as GradingState, V as InlineCorrection, W as InteractionEvent, X as InteractionKind, _ as LearnerResponseMap, $ as MediaPlaybackPolicy, a0 as MediaTrack, a3 as MultipleChoiceOption, a4 as MultipleChoiceOptionMedia, a7 as ReadAloudDimension, a8 as ReadAloudDimensionWeight, aa as ReadAloudSlowMedia, ab as RecordingBounds, ac as RecordingRef, ae as ScoringOutcome, ag as TextMatchPolicy, ah as TextMatchResult, aj as ValidationResult, am as WrittenResponseRubric, an as WrittenResponseRubricCriterion, ao as XAPIActor, ap as XAPIConfig, aq as XAPIContext, ar as XAPIContextActivities, as as XAPIError, at as XAPIObject, au as XAPIResult, av as XAPIScore, aw as XAPIStatement, ax as XAPIVerbObject, ay as levenshteinDistance, az as matchText } from './activity-f0bgZSTP.js';
 import { ScoredItem, RoundingPolicy, CompositionPolicy, AssessmentScore } from './scoring.js';
 export { AssessmentSectionInput, Band, DEFAULT_PASS_THRESHOLD, DICTATION_MAX_ACCEPTED_TRANSCRIPTS, DICTATION_MAX_EQUIVALENCES, DICTATION_MAX_EQUIVALENCE_LENGTH, DICTATION_MAX_TEXT_LENGTH, DICTATION_MAX_TRANSCRIPT_LENGTH, DictationAlignment, DictationCharOp, DictationReference, DictationWordAlignment, GradeReadAloudOptions, PassFailureReason, READ_ALOUD_MAX_DIMENSION_WEIGHT, READ_ALOUD_MAX_REFERENCE_LENGTH, READ_ALOUD_MAX_SECONDS, READ_ALOUD_MAX_TAKES, ReadAloudWordAlignment, ReadAloudWordState, RoundingMode, SPEECH_ASSESSMENT_MAX_WORDS, ScoringOptions, SectionScore, SpeechAssessment, SpeechMeasurement, SpeechPhoneme, SpeechPhonemeCandidate, SpeechPlausibilityPolicy, SpeechSyllable, SpeechUnscorable, SpeechUnscorableCode, SpeechWord, SpeechWordError, WavInspection, WavInspectionPolicy, alignDictation, alignReadAloud, classifyBand, composeAssessmentScore, computePassThreshold, dictationReferenceWords, diffDictationChars, evaluate, gradeReadAloud, gte, inspectWav, outcomeFromUnscorable, roundGrade, score, validateSpeechAssessment } from './scoring.js';
-import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-DMCM3e3P.js';
-export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, k as MediaTimeline, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-DMCM3e3P.js';
+import { a5 as SequenceSlot, a4 as SequenceEntry, I as ItemGroup, i as MediaProgress } from './index-BA9f2ydg.js';
+export { A as AiPermissionsSchema, B as BlankConfigSchema, D as DictationDataSchema, a as DictationEquivalenceSchema, b as DictationSlowMediaSchema, c as DictationToleranceSchema, F as FeedbackSchema, d as FillInTheBlanksDataSchema, G as GapSelectBankSchema, e as GapSelectChoiceSchema, f as GapSelectDataSchema, g as GapSelectGapSchema, h as ItemGroupSchema, M as MediaPlaybackSchema, j as MediaSchema, k as MediaTimeline, l as MediaTimelineSchema, m as MediaTrackSchema, n as MediaUrlSchema, o as MultipleChoiceDataSchema, p as MultipleChoiceOptionMediaSchema, q as MultipleChoiceOptionSchema, N as NativeControlHintSchema, R as ReadAloudDataSchema, r as ReadAloudSlowMediaSchema, s as RedactedActivity, t as RedactedBlankConfig, u as RedactedBlankConfigSchema, v as RedactedDictationData, w as RedactedDictationDataSchema, x as RedactedDictationSlowMedia, y as RedactedDictationSlowMediaSchema, z as RedactedFillInTheBlanksData, C as RedactedFillInTheBlanksDataSchema, E as RedactedGapSelectBank, H as RedactedGapSelectBankSchema, J as RedactedGapSelectChoice, K as RedactedGapSelectChoiceSchema, L as RedactedGapSelectData, O as RedactedGapSelectDataSchema, P as RedactedGapSelectGap, Q as RedactedGapSelectGapSchema, S as RedactedItemGroupSchema, T as RedactedMediaSchema, U as RedactedMultipleChoiceData, V as RedactedMultipleChoiceDataSchema, W as RedactedMultipleChoiceOption, X as RedactedMultipleChoiceOptionMedia, Y as RedactedMultipleChoiceOptionMediaSchema, Z as RedactedMultipleChoiceOptionSchema, _ as RedactedReadAloudData, $ as RedactedReadAloudDataSchema, a0 as RedactedStimulus, a1 as RedactedStimulusSchema, a2 as RedactedWrittenResponseData, a3 as RedactedWrittenResponseDataSchema, a6 as SequenceSlotGroup, a7 as Stimulus, a8 as StimulusKind, a9 as StimulusSchema, aa as TextMatchPolicySchema, ab as TimelineChapter, ac as TimelineChapterSchema, ad as TimelineCue, ae as TimelineCueSchema, af as WrittenResponseDataSchema, ag as WrittenResponseRubricCriterionSchema, ah as WrittenResponseRubricSchema, ai as dictationJsonSchema, aj as fillInTheBlanksJsonSchema, ak as gapSelectJsonSchema, al as itemGroupJsonSchema, am as jsonSchemaFor, an as multipleChoiceJsonSchema, ao as readAloudJsonSchema, ap as stimulusJsonSchema, aq as validateActivity, ar as validateItemGroup, as as writtenResponseJsonSchema } from './index-BA9f2ydg.js';
 import { z } from 'zod/v4';
 export { AnsweredStatementParams, CompletedStatementParams, SubmittedStatementParams, XAPIObjectParams, XAPIStatementParams, XAPIVerb, XAPIVerbKey, XAPI_VERB_DISPLAY, validateXAPIStatement, xAPIBuilder, xapiDefinitionFor } from './xapi.js';
 
@@ -128,6 +128,80 @@ declare function checkAiHint(raw: unknown, request: AiHintRequest): {
  */
 declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
 
+/**
+ * How a paper is delivered: what a learner is shown around the questions, as
+ * the school running it decides — separately from the content, so that one
+ * item serves a practice lesson and a final exam without being authored twice.
+ *
+ * Every setting is a RESTRICTION on what the SDK does by default, and every
+ * one defaults to `true`: an empty policy is exactly the behaviour there was
+ * before policies existed. A policy can take something away; it can never make
+ * a mode show what that mode cannot — no policy makes an `exam` reveal a grade,
+ * because the client in an exam has no answer key to grade with.
+ */
+interface DeliveryPolicy {
+    /**
+     * Whether a graded answer shows as graded: right and wrong marks, the score,
+     * and the author's feedback. `false` leaves the learner with "Answer
+     * submitted." — a homework quiz marked on the client and shown to the
+     * learner at the end, or a review that shows what was answered and not how
+     * it was marked. Never on in `exam`.
+     */
+    feedback?: boolean | null;
+    /**
+     * Whether the right answer is shown beside a wrong one, wherever an activity
+     * would show it: the correct option of a multiple-choice question, the
+     * correct answers `showCorrectAnswers` puts in the blanks, a dictation's
+     * transcript. `false` still marks what the learner answered right or wrong.
+     * Use it on a paper that will be sat again, or before a retry.
+     */
+    solutions?: boolean | null;
+    /**
+     * Whether the learner can ask for hints: the author's hints on a
+     * fill-in-the-blanks blank, a dictation's word hints, and AI hints. `false`
+     * switches every kind off.
+     *
+     * **The author's fill-in-the-blanks hints are on in `exam` unless this says
+     * otherwise** — they are public content, and were designed to be. Set
+     * `hints: false` on a paper of record whose hints are not part of the test.
+     */
+    hints?: boolean | null;
+    /**
+     * The deployment's switches for AI help, beside the author's switch on the
+     * item and the ports the host supplies: a feature appears only where all
+     * three allow it. `false` switches a feature off; nothing here can switch one
+     * on, and nothing switches AI help on in an `exam`.
+     *
+     * `ai: false` switches both off and `ai: true` leaves both as the other
+     * settings allow — the same as leaving `ai` out.
+     */
+    ai?: boolean | {
+        hints?: boolean | null;
+        explanations?: boolean | null;
+    } | null;
+}
+/**
+ * A policy with every setting spelled out: what {@link resolveDeliveryPolicy}
+ * returns, and what an attempt plan records, so the record of the conditions
+ * a learner sat a paper under never depends on a default that may one day
+ * change.
+ */
+interface ResolvedDeliveryPolicy {
+    feedback: boolean;
+    solutions: boolean;
+    hints: boolean;
+    ai: {
+        hints: boolean;
+        explanations: boolean;
+    };
+}
+/** One thing {@link validateDeliveryPolicy} found wrong with a policy. */
+interface DeliveryPolicyIssue {
+    /** Where, as a dotted path: `hints`, `ai.explanations`, or `''` for the policy itself. */
+    path: string;
+    message: string;
+}
+
 /**
  * The frozen record of what one attempt was served.
  *
@@ -140,6 +214,7 @@ declare function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean;
  *
  * This is the thing you persist next to the responses.
  */
+
 /** One planned position: an item, its identity, its worth, and its fingerprint. */
 interface AttemptPlanSlot {
     /**
@@ -227,6 +302,12 @@ interface AttemptPlan {
      * later; the per-slot hashes then say WHICH item moved.
      */
     planHash: string;
+    /**
+     * The delivery policy the attempt was sat under, every setting spelled out:
+     * whether feedback, solutions and hints showed, and which AI help was on.
+     * Absent when `planAttempt` was given none. Part of `planHash` when present.
+     */
+    delivery?: ResolvedDeliveryPolicy;
     slots: AttemptPlanSlot[];
     /** Sum of every slot's `points`, frozen. The denominator of the paper. */
     totalPoints: number;
@@ -257,6 +338,16 @@ interface AttemptPlanDrift {
     changedPointsSlotIds: string[];
     /** Slots presented at a different position now than they were then. */
     reorderedSlotIds: string[];
+    /**
+     * The delivery policy differs: one plan records a policy the other does not,
+     * or a setting differs. Not a change to any question, but a change to the
+     * conditions it was asked under — hints on in one, off in the other — so it
+     * breaks `matches` like any other difference.
+     *
+     * Present only when it is `true`, so a report between two plans without a
+     * policy has exactly the shape it had before policies existed.
+     */
+    deliveryChanged?: true;
 }
 
 /** Options for {@link planAttempt}. */
@@ -281,6 +372,20 @@ interface PlanAttemptOptions<TItem> {
      *         number — a slot worth `NaN` points would poison the whole total.
      */
     points?: (slot: SequenceSlot<TItem>) => number;
+    /**
+     * The delivery policy this attempt is sat under — whether hints were
+     * offered, whether AI help was, whether feedback and solutions showed.
+     * Frozen into the plan with every setting spelled out, so the record of the
+     * conditions a grade was earned under does not depend on today's defaults.
+     *
+     * Recorded only when given: a plan made without one is byte-identical to a
+     * plan made before policies existed, `planHash` included.
+     *
+     * @throws Error when the policy does not pass `validateDeliveryPolicy` —
+     *         a misspelled restriction is no restriction, and a plan is the
+     *         record an appeal reads.
+     */
+    delivery?: DeliveryPolicy | null;
 }
 /**
  * Freezes what an attempt is being served: the presented order, each slot's
@@ -676,6 +781,45 @@ declare function contentHash(value: unknown): string;
  */
 declare function countWords(text: string): number;
 
+/**
+ * The policy that restricts nothing: every setting `true`. It is what an absent
+ * policy resolves to, and it is exactly the behaviour the SDK had before
+ * delivery policies existed.
+ */
+declare const OPEN_DELIVERY_POLICY: ResolvedDeliveryPolicy;
+/**
+ * A policy with every setting spelled out — see {@link DeliveryPolicy}.
+ *
+ * Tolerant, because it runs where a learner is waiting: nothing here throws.
+ * A value it cannot read restricts rather than allows (see above), and a
+ * policy that is not an object at all restricts everything. Check a policy
+ * before you store it with {@link validateDeliveryPolicy}; `planAttempt` does.
+ */
+declare function resolveDeliveryPolicy(policy: unknown): ResolvedDeliveryPolicy;
+/**
+ * The strictest of several policies: a setting is on only where every one of
+ * them leaves it on. How a course's policy and an assessment's combine, and
+ * how a pager's policy wins over whatever a question it draws was handed.
+ */
+declare function combineDeliveryPolicies(...policies: unknown[]): ResolvedDeliveryPolicy;
+/**
+ * Checks a policy before it is stored: each setting `true`, `false`, `null`
+ * or absent, and nothing else — no misspelled setting, no string standing in
+ * for a boolean.
+ *
+ * Stricter than {@link resolveDeliveryPolicy} on purpose. A misspelled
+ * restriction (`hint: false`) is silently no restriction at all, and a
+ * policy is a record of the conditions a paper was sat under: it is worth
+ * refusing before it is written down, rather than read charitably after.
+ */
+declare function validateDeliveryPolicy(policy: unknown): {
+    success: true;
+    data: DeliveryPolicy;
+} | {
+    success: false;
+    issues: DeliveryPolicyIssue[];
+};
+
 /** Thrown when activity data fails schema validation at a component boundary. */
 declare class ActivitySchemaError extends Error {
     readonly activityType: string;
@@ -1468,4 +1612,4 @@ interface ThemeTokens {
     '--lk-transition-base': string;
 }
 
-export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };
+export { AI_EXPLANATION_TYPES, AI_HINT_TYPES, AI_TEXT_MAX_LENGTH, ActivityData, ActivityDataMap, ActivityMedia, ActivitySchemaError, ActivityType, type ActivityTypeAuthoring, type ActivityTypeDescriptor, type ActivityTypeInterop, type ActivityTypeScoring, AiActivityInput, AiExplanationRequest, AiFeature, AiGrade, AiHintRequest, AiItemFacts, AiRefusal, AiSupportedActivityType, AiTextResult, AssessmentScore, type AttemptPlan, type AttemptPlanDrift, type AttemptPlanSlot, type AttemptProgress, type AttemptState, CompositionPolicy, CriterionScore, DeferredScoringError, DeferredScoringPartial, type DeliveryPolicy, type DeliveryPolicyIssue, DictationData, DictationLearnerResponse, type DraftComplete, type DraftContext, type DraftIssue, type DraftNotComplete, type DraftSeverity, type DraftValidationResult, type FieldPolicy, FillInTheBlanksData, FillInTheBlanksLearnerResponse, type FlattenSequenceOptions, GapSelectData, GapSelectLearnerResponse, type GradeFromRubricOptions, GradeRecord, INTERACTIVE_VIDEO_ITEM_TYPES, type InteractiveVideoItemType, ItemGroup, ItemOutcome, LearnerResponse, type MediaBudgetRef, type MediaPlayClaim, type MediaPlayGrant, type MediaPlayLedger, type MediaPlayLedgerEntry, MediaProgress, type MissingOutcomePolicy, MultipleChoiceData, MultipleChoiceLearnerResponse, NativeControlHint, OPEN_DELIVERY_POLICY, type PartialScoringResult, type PlanAttemptOptions, type PlannableEntry, ReadAloudData, ReadAloudLearnerResponse, type RedactOptions, type RedactedActivityData, type RedactedItemGroup, RedactedScoringError, type RegisteredActivityTypeDescriptor, type ResolvedDeliveryPolicy, type ResolvedPlaybackPolicy, type ResponseDiffEntry, RoundingPolicy, ScoredItem, ScoringDetail, ScoringResult, type SeededShuffleOptions, type Sensitivity, SequenceEntry, SequenceSlot, type ShuffleVersion, TIMELINE_MAX_CHAPTERS, TIMELINE_MAX_ITEMS, TIMELINE_MAX_QUIZZES, TIMELINE_MAX_TITLE_LENGTH, type ThemeTokens, UnknownActivityTypeError, ValidationError, WrittenResponseData, WrittenResponseLearnerResponse, type XAPIInteractionType, aiAllowedByContent, aiExplanationRequest, aiGradeOf, aiHintRequest, aiSupports, assertRedacted, assertRedactedItemGroup, buildAiFacts, canonicalJson, checkAiExplanation, checkAiHint, combineDeliveryPolicies, composeTimelineScore, contentHash, countWords, createDraft, createInteractiveVideoDraft, createItemGroupDraft, defineActivityType, dictationType, diffResponses, entryKeyOf, fillInTheBlanksType, fingerprint, flattenSequence, gapSelectType, getActivityTypeDescriptor, gradeFromRubric, hasGrade, hashSeed, hintRevealsAnswer, isInteractiveVideoItemType, isItemGroup, multipleChoiceType, outcomeFromGrade, planAttempt, planMediaBudgets, readAiTextResult, readAloudType, readMediaProgress, redact, redactItemGroup, registerActivityType, registeredActivityTypes, resolveDeliveryPolicy, resolvePlaybackPolicy, restoreAttemptState, restoreMediaPlayLedger, scoredItemsFromPlan, seededShuffle, serializeAttemptState, serializeMediaPlayLedger, slotMediaKey, stimulusMediaKey, validateDeliveryPolicy, validateDraft, validateItemGroupDraft, verifyAttemptPlan, writtenResponseType };

package/dist/index.js

@@ -208,6 +208,106 @@ function contentHash(value) {
   return fingerprint(canonicalJson(value));
 }
 
+// src/delivery.ts
+var OPEN_DELIVERY_POLICY = Object.freeze({
+  feedback: true,
+  solutions: true,
+  hints: true,
+  ai: Object.freeze({ hints: true, explanations: true })
+});
+var SETTINGS = ["feedback", "solutions", "hints"];
+var AI_SETTINGS = ["hints", "explanations"];
+function allows(value) {
+  return value === void 0 || value === null || value === true;
+}
+function resolveDeliveryPolicy(policy) {
+  if (policy === void 0 || policy === null) {
+    return OPEN_DELIVERY_POLICY;
+  }
+  if (typeof policy !== "object" || Array.isArray(policy)) {
+    return {
+      feedback: false,
+      solutions: false,
+      hints: false,
+      ai: { hints: false, explanations: false }
+    };
+  }
+  const given = policy;
+  const ai = given.ai;
+  const aiGiven = ai === void 0 || ai === null || ai === true ? {} : typeof ai === "object" && !Array.isArray(ai) ? ai : { hints: false, explanations: false };
+  return {
+    feedback: allows(given.feedback),
+    solutions: allows(given.solutions),
+    hints: allows(given.hints),
+    ai: { hints: allows(aiGiven.hints), explanations: allows(aiGiven.explanations) }
+  };
+}
+function combineDeliveryPolicies(...policies) {
+  const resolved = policies.map(resolveDeliveryPolicy);
+  const every = (read) => resolved.every(read);
+  return {
+    feedback: every((one) => one.feedback),
+    solutions: every((one) => one.solutions),
+    hints: every((one) => one.hints),
+    ai: {
+      hints: every((one) => one.ai.hints),
+      explanations: every((one) => one.ai.explanations)
+    }
+  };
+}
+function validateDeliveryPolicy(policy) {
+  const issues = [];
+  if (policy === void 0 || policy === null) {
+    return { success: true, data: {} };
+  }
+  if (typeof policy !== "object" || Array.isArray(policy)) {
+    return {
+      success: false,
+      issues: [{ path: "", message: "A delivery policy is an object of settings." }]
+    };
+  }
+  const given = policy;
+  for (const key of Object.keys(given)) {
+    if (key === "ai") {
+      continue;
+    }
+    if (!SETTINGS.includes(key)) {
+      issues.push({
+        path: key,
+        message: `"${key}" is not a delivery setting. The settings are feedback, solutions, hints and ai.`
+      });
+      continue;
+    }
+    const value = given[key];
+    if (value !== true && value !== false && value !== null && value !== void 0) {
+      issues.push({ path: key, message: `"${key}" must be true, false or null.` });
+    }
+  }
+  const ai = given.ai;
+  if (ai !== void 0 && ai !== null && ai !== true && ai !== false) {
+    if (typeof ai !== "object" || Array.isArray(ai)) {
+      issues.push({
+        path: "ai",
+        message: '"ai" must be true, false, or an object of hints and explanations.'
+      });
+    } else {
+      for (const [key, value] of Object.entries(ai)) {
+        if (!AI_SETTINGS.includes(key)) {
+          issues.push({
+            path: `ai.${key}`,
+            message: `"ai.${key}" is not an AI setting. The settings are hints and explanations.`
+          });
+          continue;
+        }
+        if (value !== true && value !== false && value !== null && value !== void 0) {
+          issues.push({ path: `ai.${key}`, message: `"ai.${key}" must be true, false or null.` });
+        }
+      }
+    }
+  }
+  return issues.length > 0 ? { success: false, issues } : { success: true, data: given };
+}
+
 // src/shuffle.ts
 function hashSeed(input) {
   let h = 2166136261 >>> 0;
@@ -511,6 +611,7 @@ function planSlot(slot, points) {
 }
 function planAttempt(entries, options = {}) {
   const { seed, shuffleEntries, points } = options;
+  const delivery = frozenDelivery(options.delivery);
   const slots = flattenSequence(entries, {
     ...shuffleEntries !== void 0 ? { shuffleEntries } : {},
     ...seed !== void 0 ? { seed } : {}
@@ -525,7 +626,11 @@ function planAttempt(entries, options = {}) {
     // The plan's own fingerprint covers the slots verbatim — identity, order,
     // points and content hashes — so one stored value answers "is this still
     // the paper that was sat?" and the per-slot hashes then say what moved.
-    planHash: contentHash(planned),
+    // A policy joins it when there is one: the same paper sat with hints and
+    // without is two different attempts. Without one, the fingerprint is the
+    // one every plan before policies had.
+    planHash: contentHash(delivery === void 0 ? planned : { slots: planned, delivery }),
+    ...delivery !== void 0 ? { delivery } : {},
     slots: planned,
     totalPoints
   };
@@ -540,6 +645,7 @@ function verifyAttemptPlan(plan, current) {
   const changedCueSlotIds = [];
   const changedPointsSlotIds = [];
   const reorderedSlotIds = [];
+  const deliveryChanged = contentHash(plan.delivery ?? null) !== contentHash(current.delivery ?? null);
   for (const slot of plan.slots) {
     const now = after.get(slot.slotId);
     if (now === void 0) {
@@ -562,16 +668,33 @@ function verifyAttemptPlan(plan, current) {
     }
   }
   return {
-    matches: missingSlotIds.length === 0 && addedSlotIds.length === 0 && changedSlotIds.length === 0 && changedStimulusSlotIds.length === 0 && changedCueSlotIds.length === 0 && changedPointsSlotIds.length === 0 && reorderedSlotIds.length === 0,
+    matches: missingSlotIds.length === 0 && addedSlotIds.length === 0 && changedSlotIds.length === 0 && changedStimulusSlotIds.length === 0 && changedCueSlotIds.length === 0 && changedPointsSlotIds.length === 0 && reorderedSlotIds.length === 0 && !deliveryChanged,
     missingSlotIds,
     addedSlotIds,
     changedSlotIds,
     changedStimulusSlotIds,
     changedCueSlotIds,
     changedPointsSlotIds,
-    reorderedSlotIds
+    reorderedSlotIds,
+    // Present only when it is true, as `rejectedSlotIds` is on a composed
+    // score: a drift report between two plans without a policy — every one
+    // written before policies existed — keeps exactly the shape it had.
+    ...deliveryChanged ? { deliveryChanged: true } : {}
   };
 }
+function frozenDelivery(policy) {
+  if (policy === void 0 || policy === null) {
+    return void 0;
+  }
+  const checked = validateDeliveryPolicy(policy);
+  if (!checked.success) {
+    const first = checked.issues[0];
+    throw new Error(
+      `planAttempt: the delivery policy is not one to record \u2014 ${first?.message ?? "invalid"}` + (checked.issues.length > 1 ? ` (and ${checked.issues.length - 1} more)` : "")
+    );
+  }
+  return resolveDeliveryPolicy(checked.data);
+}
 function missingOutcome(slot, policy) {
   if (typeof policy === "function") {
     return policy(slot);
@@ -1537,6 +1660,7 @@ export {
   MultipleChoiceOptionMediaSchema,
   MultipleChoiceOptionSchema,
   NativeControlHintSchema,
+  OPEN_DELIVERY_POLICY,
   READ_ALOUD_MAX_DIMENSION_WEIGHT,
   READ_ALOUD_MAX_REFERENCE_LENGTH,
   READ_ALOUD_MAX_SECONDS,
@@ -1589,6 +1713,7 @@ export {
   checkAiExplanation,
   checkAiHint,
   classifyBand,
+  combineDeliveryPolicies,
   composeAssessmentScore,
   composeTimelineScore,
   computePassThreshold,
@@ -1639,6 +1764,7 @@ export {
   redactItemGroup,
   registerActivityType,
   registeredActivityTypes,
+  resolveDeliveryPolicy,
   resolvePlaybackPolicy,
   restoreAttemptState,
   restoreMediaPlayLedger,
@@ -1652,6 +1778,7 @@ export {
   stimulusJsonSchema,
   stimulusMediaKey,
   validateActivity,
+  validateDeliveryPolicy,
   validateDraft,
   validateItemGroup,
   validateItemGroupDraft,