@intellectif/lk-core 1.4.0 → 1.5.0

package/dist/index.cjs

@@ -1,82 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_registry = require("./registry-DVi0LR_i.cjs");
-const require_ai_writing = require("./ai-writing-G6tnCGzw.cjs");
-const require_scoring = require("./scoring-B2_HEhMT.cjs");
-const require_item_group = require("./item-group-DroFXgLb.cjs");
-const require_schemas = require("./schemas-DVbAOrtd.cjs");
-const require_xapi = require("./xapi-DNzkSJ0S.cjs");
-//#region src/content-hash.ts
-/**
-* Content fingerprinting — "is this the same content the learner was served?"
-*
-* A recorded attempt outlives the content it was taken against. Papers get
-* corrected, a typo is fixed, an option is reworded — and six months later a
-* remark, an appeal, or a per-item analysis is run against content that is no
-* longer what the learner saw. Nothing warns anybody, because the ids all still
-* match. A fingerprint stored with the attempt turns that silent drift into a
-* question somebody can answer.
-*/
-/**
-* Deterministic JSON: object keys sorted, arrays left in order, `undefined`
-* omitted from objects (matching `JSON.stringify`) and rendered as `null`
-* inside arrays.
-*
-* Key order is the whole point. Two objects that differ only in the order
-* their keys happened to be written are the SAME content, and a fingerprint
-* that disagreed would raise a false alarm every time a payload made a
-* round-trip through a different serializer.
-*/
-function canonicalJson(value, seen = /* @__PURE__ */ new Set()) {
-	if (value === null) return "null";
-	if (typeof value === "number") return Number.isFinite(value) ? JSON.stringify(value === 0 ? 0 : value) : `"#${String(value)}"`;
-	if (typeof value === "string" || typeof value === "boolean") return JSON.stringify(value);
-	if (typeof value === "bigint") return `"#${value.toString()}n"`;
-	if (typeof value === "object") {
-		if (seen.has(value)) throw new Error("canonicalJson: the value contains a circular reference and cannot be fingerprinted.");
-		seen.add(value);
-		try {
-			if (Array.isArray(value)) return `[${value.map((element) => element === void 0 ? "null" : canonicalJson(element, seen)).join(",")}]`;
-			const source = value;
-			const parts = [];
-			for (const key of Object.keys(source).sort()) {
-				const entry = source[key];
-				if (entry === void 0) continue;
-				parts.push(`${JSON.stringify(key)}:${canonicalJson(entry, seen)}`);
-			}
-			return `{${parts.join(",")}}`;
-		} finally {
-			seen.delete(value);
-		}
-	}
-	return "null";
-}
-const FNV_OFFSET = 14695981039346656037n;
-const FNV_PRIME = 1099511628211n;
-const MASK64 = (1n << 64n) - 1n;
-/**
-* FNV-1a over the UTF-8 bytes of `input`, as 16 lowercase hex digits.
-*
-* **This is a change-detection fingerprint, not a tamper-evident signature.**
-* It is deterministic across runtimes and dependency-free, which is what makes
-* it usable in a stored grade record — but an adversary who can edit content
-* can also, with effort, preserve the fingerprint. If you need the stronger
-* property, sign the plan with a key the content author does not hold; this
-* exists to catch honest edits, which is what actually happens.
-*/
-function fingerprint(input) {
-	const bytes = new TextEncoder().encode(input);
-	let hash = FNV_OFFSET;
-	for (const byte of bytes) hash = (hash ^ BigInt(byte)) * FNV_PRIME & MASK64;
-	return hash.toString(16).padStart(16, "0");
-}
-/**
-* Fingerprints any JSON-serialisable value through {@link canonicalJson}, so
-* the result depends on the content and not on how it was written.
-*/
-function contentHash(value) {
-	return fingerprint(canonicalJson(value));
-}
-//#endregion
+const require_registry = require("./registry-Ce00A_OW.cjs");
+const require_ai_writing = require("./ai-writing-Cen7-3qs.cjs");
+const require_scoring = require("./scoring-lKQVYsxy.cjs");
+const require_item_group = require("./item-group-DEB7nLID.cjs");
+const require_schemas = require("./schemas-DksueYsu.cjs");
+const require_xapi = require("./xapi-NYrTlpID.cjs");
 //#region src/delivery.ts
 /**
 * The policy that restricts nothing: every setting `true`. It is what an absent
@@ -232,44 +160,6 @@ function validateDeliveryPolicy(policy) {
 	};
 }
 //#endregion
-//#region src/shuffle.ts
-/**
-* Seeded, deterministic shuffling — the ONE algorithm every presentation-order
-* decision in the SDK goes through: option order in a multiple-choice item,
-* item order inside an item group, entry order in a sequence. A server and a
-* client holding the same seed derive the same order, and an order recorded
-* against an attempt can be rebuilt later from nothing but its seed.
-*
-* STABILITY: the hash and the generator are part of the wire contract. A
-* stored attempt may hold only a seed and rely on this function to reproduce
-* the order it presented; changing either would silently re-order every
-* recorded attempt. Any change here is a package major, and the pinned
-* permutation test exists so an accidental one fails loudly.
-*/
-/** FNV-1a hash of a string → unsigned 32-bit integer. */
-function hashSeed(input) {
-	let h = 2166136261;
-	for (let i = 0; i < input.length; i += 1) {
-		h ^= input.charCodeAt(i);
-		h = Math.imul(h, 16777619) >>> 0;
-	}
-	return h;
-}
-/** LCG-driven Fisher–Yates over a 32-bit seed; returns a permutation (no loss, no duplicate). */
-function shuffleWithSeed(items, seed, version) {
-	const out = [...items];
-	let s = seed >>> 0 || 1;
-	for (let i = out.length - 1; i > 0; i -= 1) {
-		s = Math.imul(s, 1664525) + 1013904223 >>> 0;
-		const j = version === 2 ? Math.floor(s / 4294967296 * (i + 1)) : s % (i + 1);
-		[out[i], out[j]] = [out[j], out[i]];
-	}
-	return out;
-}
-function seededShuffle(items, seed, options = {}) {
-	return shuffleWithSeed(items, hashSeed(seed), options.version ?? 1);
-}
-//#endregion
 //#region src/item-group.ts
 /** Narrows a sequence entry to an item group. */
 function isItemGroup(entry) {
@@ -342,7 +232,7 @@ function flattenSequence(entries, options = {}) {
 		entry,
 		entryIndex
 	}));
-	const ordered = shuffleEntries ? seededShuffle(authored, `${seed}:entries`, { version: 1 }) : authored;
+	const ordered = shuffleEntries ? require_scoring.seededShuffle(authored, `${seed}:entries`, { version: 1 }) : authored;
 	const slots = [];
 	for (const { entry, entryIndex } of ordered) {
 		const entryKey = keyOf(entry) ?? String(entryIndex);
@@ -361,7 +251,7 @@ function flattenSequence(entries, options = {}) {
 			item,
 			itemIndex
 		}));
-		const presented = timeline !== void 0 ? inQuizOrder(items, timeline) : entry.shuffle === "within-group" ? seededShuffle(items, `${seed}:group:${entry.id}`, { version: 1 }) : items;
+		const presented = timeline !== void 0 ? inQuizOrder(items, timeline) : entry.shuffle === "within-group" ? require_scoring.seededShuffle(items, `${seed}:group:${entry.id}`, { version: 1 }) : items;
 		const size = presented.length;
 		presented.forEach(({ item, itemIndex }, position) => {
 			const cue = timeline?.cues.find((candidate) => candidate.itemIds.includes(item.id));
@@ -579,11 +469,11 @@ function planSlot(slot, points) {
 		activityId: slot.activity.id,
 		activityType: slot.activity.type,
 		points,
-		contentHash: contentHash(contentOf(slot.activity)),
+		contentHash: require_scoring.contentHash(contentOf(slot.activity)),
 		...slot.group !== void 0 ? { group: {
 			id: slot.group.id,
 			...slot.group.title !== void 0 ? { title: slot.group.title } : {},
-			stimulusHash: contentHash(slot.group.stimulus),
+			stimulusHash: require_scoring.contentHash(slot.group.stimulus),
 			...slot.group.cue !== void 0 ? { cue: {
 				id: slot.group.cue.id,
 				at: slot.group.cue.at,
@@ -624,7 +514,7 @@ function planAttempt(entries, options = {}) {
 		planVersion: "1.0",
 		...seed !== void 0 ? { seed } : {},
 		...shuffleEntries !== void 0 ? { shuffleEntries } : {},
-		planHash: contentHash(delivery === void 0 && scoring === void 0 ? planned : {
+		planHash: require_scoring.contentHash(delivery === void 0 && scoring === void 0 ? planned : {
 			slots: planned,
 			...delivery !== void 0 ? { delivery } : {},
 			...scoring !== void 0 ? { scoring } : {}
@@ -669,14 +559,14 @@ function verifyAttemptPlan(plan, current) {
 	const changedCueSlotIds = [];
 	const changedPointsSlotIds = [];
 	const reorderedSlotIds = [];
-	const deliveryChanged = contentHash(plan.delivery ?? null) !== contentHash(current.delivery ?? null);
-	const scoringChanged = contentHash(plan.scoring ?? null) !== contentHash(current.scoring ?? null);
+	const deliveryChanged = require_scoring.contentHash(plan.delivery ?? null) !== require_scoring.contentHash(current.delivery ?? null);
+	const scoringChanged = require_scoring.contentHash(plan.scoring ?? null) !== require_scoring.contentHash(current.scoring ?? null);
 	for (const slot of plan.slots) {
 		const now = after.get(slot.slotId);
 		if (now === void 0) continue;
 		if (now.contentHash !== slot.contentHash) changedSlotIds.push(slot.slotId);
 		if (now.group?.stimulusHash !== slot.group?.stimulusHash) changedStimulusSlotIds.push(slot.slotId);
-		if (contentHash(now.group?.cue ?? null) !== contentHash(slot.group?.cue ?? null)) changedCueSlotIds.push(slot.slotId);
+		if (require_scoring.contentHash(now.group?.cue ?? null) !== require_scoring.contentHash(slot.group?.cue ?? null)) changedCueSlotIds.push(slot.slotId);
 		if (now.points !== slot.points) changedPointsSlotIds.push(slot.slotId);
 		if (now.index !== slot.index) reorderedSlotIds.push(slot.slotId);
 	}
@@ -877,7 +767,7 @@ function diffResponses(before, after) {
 			});
 			continue;
 		}
-		if (canonicalJson(from) !== canonicalJson(to)) entries.push({
+		if (require_scoring.canonicalJson(from) !== require_scoring.canonicalJson(to)) entries.push({
 			slotId,
 			change: "changed",
 			...from !== void 0 ? { before: from } : {},
@@ -925,6 +815,8 @@ function redactValue(value, policy, reveal) {
 			if (keepField(classification, reveal)) output[key] = fieldValue;
 			continue;
 		}
+		const guard = require_registry.guardOf(classification);
+		if (guard !== void 0 && !guard(fieldValue)) continue;
 		const nested = redactValue(fieldValue, classification, reveal);
 		if (nested !== void 0 && !isEmptyObject(nested)) output[key] = nested;
 	}
@@ -1165,6 +1057,7 @@ exports.AI_CRITIQUE_MAX_FINDINGS = require_ai_writing.AI_CRITIQUE_MAX_FINDINGS;
 exports.AI_DRAFTS_MAX_COUNT = require_ai_writing.AI_DRAFTS_MAX_COUNT;
 exports.AI_DRAFTS_MAX_REPAIRS = require_ai_writing.AI_DRAFTS_MAX_REPAIRS;
 exports.AI_EXPLANATION_TYPES = require_ai_writing.AI_EXPLANATION_TYPES;
+exports.AI_GRADING_PROBABILITY_TOLERANCE = require_ai_writing.AI_GRADING_PROBABILITY_TOLERANCE;
 exports.AI_HINT_TYPES = require_ai_writing.AI_HINT_TYPES;
 exports.AI_MATERIAL_MAX_LENGTH = require_ai_writing.AI_MATERIAL_MAX_LENGTH;
 exports.AI_TEXT_MAX_LENGTH = require_ai_writing.AI_TEXT_MAX_LENGTH;
@@ -1203,6 +1096,7 @@ exports.aiDraftsRepairRequest = require_ai_writing.aiDraftsRepairRequest;
 exports.aiDraftsRequest = require_ai_writing.aiDraftsRequest;
 exports.aiExplanationRequest = require_ai_writing.aiExplanationRequest;
 exports.aiGradeOf = require_ai_writing.aiGradeOf;
+exports.aiGradingRequest = require_ai_writing.aiGradingRequest;
 exports.aiHintRequest = require_ai_writing.aiHintRequest;
 exports.aiSupports = require_ai_writing.aiSupports;
 exports.aiWritingFeedbackRequest = require_ai_writing.aiWritingFeedbackRequest;
@@ -1211,11 +1105,13 @@ exports.alignReadAloud = require_scoring.alignReadAloud;
 exports.assertRedacted = assertRedacted;
 exports.assertRedactedItemGroup = assertRedactedItemGroup;
 exports.buildAiFacts = require_ai_writing.buildAiFacts;
-exports.canonicalJson = canonicalJson;
+exports.calibrationReport = require_scoring.calibrationReport;
+exports.canonicalJson = require_scoring.canonicalJson;
 exports.checkAiCoaching = require_ai_writing.checkAiCoaching;
 exports.checkAiCritique = require_ai_writing.checkAiCritique;
 exports.checkAiDrafts = require_ai_writing.checkAiDrafts;
 exports.checkAiExplanation = require_ai_writing.checkAiExplanation;
+exports.checkAiGrading = require_ai_writing.checkAiGrading;
 exports.checkAiHint = require_ai_writing.checkAiHint;
 exports.checkAiWritingFeedback = require_ai_writing.checkAiWritingFeedback;
 exports.classifyBand = require_scoring.classifyBand;
@@ -1223,7 +1119,7 @@ exports.combineDeliveryPolicies = combineDeliveryPolicies;
 exports.composeAssessmentScore = require_scoring.composeAssessmentScore;
 exports.composeTimelineScore = composeTimelineScore;
 exports.computePassThreshold = require_scoring.computePassThreshold;
-exports.contentHash = contentHash;
+exports.contentHash = require_scoring.contentHash;
 exports.countWords = require_registry.countWords;
 exports.createDraft = require_ai_writing.createDraft;
 exports.createInteractiveVideoDraft = require_ai_writing.createInteractiveVideoDraft;
@@ -1242,18 +1138,21 @@ exports.evaluate = require_scoring.evaluate;
 exports.evaluateTries = require_scoring.evaluateTries;
 exports.fillInTheBlanksJsonSchema = require_schemas.fillInTheBlanksJsonSchema;
 exports.fillInTheBlanksType = require_registry.fillInTheBlanksType;
-exports.fingerprint = fingerprint;
+exports.fingerprint = require_scoring.fingerprint;
 exports.flattenSequence = flattenSequence;
 exports.gapSelectJsonSchema = require_schemas.gapSelectJsonSchema;
 exports.gapSelectType = require_registry.gapSelectType;
 exports.generateDrafts = require_ai_writing.generateDrafts;
 exports.getActivityTypeDescriptor = require_registry.getActivityTypeDescriptor;
+exports.gradeFromJudgement = require_scoring.gradeFromJudgement;
 exports.gradeFromRubric = require_scoring.gradeFromRubric;
 exports.gradeReadAloud = require_scoring.gradeReadAloud;
+exports.graderConfiguration = require_scoring.graderConfiguration;
 exports.gte = require_scoring.gte;
 exports.hasGrade = require_scoring.hasGrade;
-exports.hashSeed = hashSeed;
+exports.hashSeed = require_scoring.hashSeed;
 exports.hintRevealsAnswer = require_ai_writing.hintRevealsAnswer;
+exports.inAuditSample = require_scoring.inAuditSample;
 exports.inspectWav = require_scoring.inspectWav;
 exports.interactiveVideoFromDrafts = require_ai_writing.interactiveVideoFromDrafts;
 exports.isBuiltInActivityType = require_registry.isBuiltInActivityType;
@@ -1266,6 +1165,7 @@ exports.matchText = require_registry.matchText;
 exports.multipleChoiceJsonSchema = require_schemas.multipleChoiceJsonSchema;
 exports.multipleChoiceType = require_registry.multipleChoiceType;
 exports.outcomeFromGrade = require_scoring.outcomeFromGrade;
+exports.outcomeFromRoutedGrade = require_scoring.outcomeFromRoutedGrade;
 exports.outcomeFromUnscorable = require_scoring.outcomeFromUnscorable;
 exports.planAttempt = planAttempt;
 exports.planMediaBudgets = planMediaBudgets;
@@ -1283,10 +1183,11 @@ exports.resolvePlaybackPolicy = resolvePlaybackPolicy;
 exports.restoreAttemptState = restoreAttemptState;
 exports.restoreMediaPlayLedger = restoreMediaPlayLedger;
 exports.roundGrade = require_scoring.roundGrade;
+exports.routeGrade = require_scoring.routeGrade;
 exports.score = require_scoring.score;
 exports.scoreTries = require_scoring.scoreTries;
 exports.scoredItemsFromPlan = scoredItemsFromPlan;
-exports.seededShuffle = seededShuffle;
+exports.seededShuffle = require_scoring.seededShuffle;
 exports.serializeAttemptState = serializeAttemptState;
 exports.serializeMediaPlayLedger = serializeMediaPlayLedger;
 exports.slotMediaKey = slotMediaKey;