@intellectif/lk-core 1.3.0 → 1.4.0

package/dist/{ai-writing-DCVkv4Zj.cjs → ai-writing-G6tnCGzw.cjs}

@@ -1,6 +1,95 @@
 const require_registry = require("./registry-DVi0LR_i.cjs");
 const require_scoring = require("./scoring-B2_HEhMT.cjs");
 const require_item_group = require("./item-group-DroFXgLb.cjs");
+//#region src/ai-material.ts
+/**
+* What a model is told about the group a question sits in: the material the
+* learner reads and sees beside it.
+*
+* Internal: the request builders in `ai.ts` and `ai-writing.ts` are its public
+* face, through their `group` input.
+*/
+/**
+* The longest material text a model is given, in code points. A longer one is
+* cut and marked `truncated`: a long reading passage on an exam paper runs to
+* 4,000–7,000.
+*/
+const AI_MATERIAL_MAX_LENGTH = 12e3;
+const KINDS$2 = {
+	text: true,
+	audio: true,
+	video: true,
+	image: true,
+	mixed: true
+};
+const MEDIA_TYPES = {
+	image: true,
+	audio: true,
+	video: true,
+	embed: true
+};
+const isRecord$4 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** A string with something in it, as written; otherwise nothing. */
+const filled = (value) => typeof value === "string" && value.trim() !== "" ? value : void 0;
+/**
+* `text` cut to {@link AI_MATERIAL_MAX_LENGTH} code points. The cut falls at
+* the last space in its second half, so no word is broken; in a script written
+* without spaces, at the limit itself.
+*/
+function cut(text) {
+	const points = [...text];
+	if (points.length <= 12e3) return {
+		text,
+		truncated: false
+	};
+	let end = AI_MATERIAL_MAX_LENGTH;
+	for (let at = AI_MATERIAL_MAX_LENGTH; at >= AI_MATERIAL_MAX_LENGTH / 2; at -= 1) if (/\s/u.test(points[at])) {
+		end = at;
+		break;
+	}
+	return {
+		text: points.slice(0, end).join("").trimEnd(),
+		truncated: true
+	};
+}
+/**
+* The facts of `group`'s material, or `null` without a group or a stimulus it
+* can read: not an object, or of a kind the SDK does not know.
+*
+* Only what the learner sees reaches a model. The `transcript` is author-only
+* and never read, so the facts are the same for a whole group and a redacted
+* one; a media address is never read either, since a model cannot open one
+* and a signed address must not end up in a prompt. Each field is read once.
+*/
+function materialFacts(group) {
+	if (!isRecord$4(group)) return null;
+	const stimulus = group.stimulus;
+	if (!isRecord$4(stimulus)) return null;
+	const kind = stimulus.kind;
+	if (typeof kind !== "string" || !Object.hasOwn(KINDS$2, kind)) return null;
+	const title = filled(stimulus.title) ?? filled(group.title);
+	const body = filled(stimulus.body);
+	const text = body === void 0 ? void 0 : cut(body);
+	const rawMedia = stimulus.media;
+	const mediaType = isRecord$4(rawMedia) ? rawMedia.type : void 0;
+	const alt = isRecord$4(rawMedia) ? filled(rawMedia.alt) : void 0;
+	const media = typeof mediaType === "string" && Object.hasOwn(MEDIA_TYPES, mediaType) ? {
+		type: mediaType,
+		...alt !== void 0 ? { alt } : {}
+	} : void 0;
+	const attribution = filled(stimulus.attribution);
+	const locale = filled(stimulus.locale);
+	return {
+		kind,
+		...title !== void 0 ? { title } : {},
+		...text !== void 0 ? { text: text.text } : {},
+		...text?.truncated === true ? { truncated: true } : {},
+		...media !== void 0 ? { media } : {},
+		...attribution !== void 0 ? { attribution } : {},
+		...locale !== void 0 ? { locale } : {}
+	};
+}
+//#endregion
 //#region src/ai-text.ts
 /**
 * How the SDK reads text a model wrote, before a learner does. Internal: shared
@@ -341,6 +430,10 @@ function gradeLocally(data, response) {
 * positive and finite, `score` finite from 0 to it) gets no explanation at all:
 * explaining 85 "out of 1" would tell the model a wrong answer was correct, and
 * grading locally instead would speak to a grade the screen does not show.
+*
+* `group` is the item group the question sits in: its material — the passage,
+* or the instructions the group's questions share — goes with the request as
+* `material`, as the learner sees it.
 */
 function aiExplanationRequest(input) {
 	const { data, response, outcome, learnerLocale } = input;
@@ -366,10 +459,12 @@ function aiExplanationRequest(input) {
 	if (grade === null) return null;
 	const facts = buildAiFacts(data, response, details);
 	if (facts === null) return null;
+	const material = materialFacts(input.group);
 	return {
 		feature: "explanation",
 		facts,
 		grade,
+		...material !== null ? { material } : {},
 		...learnerLocale !== void 0 ? { learnerLocale } : {}
 	};
 }
@@ -380,7 +475,11 @@ function aiExplanationRequest(input) {
 *
 * The facts carry the key, and which parts the learner has right so far, so a
 * model can hint where it helps. The learner never sees them; a hint that
-* contains an answer is refused by {@link checkAiHint}.
+* contains an answer is refused by {@link checkAiHint}, whatever it quotes —
+* the group's material included.
+*
+* `group` is the item group the question sits in, as for
+* {@link aiExplanationRequest}.
 */
 function aiHintRequest(input) {
 	const { data, previousHints, learnerLocale } = input;
@@ -388,11 +487,13 @@ function aiHintRequest(input) {
 	const response = input.response ?? emptyResponse(data.type);
 	const facts = buildAiFacts(data, response, (response === null ? null : gradeLocally(data, response))?.details ?? null);
 	if (facts === null) return null;
+	const material = materialFacts(input.group);
 	return {
 		feature: "hint",
 		facts,
 		hintNumber: previousHints.length + 1,
 		previousHints: [...previousHints],
+		...material !== null ? { material } : {},
 		...learnerLocale !== void 0 ? { learnerLocale } : {}
 	};
 }
@@ -2204,7 +2305,9 @@ const MAX_TAG_LENGTH = 40;
 * The facts are the task as the learner saw it, the draft verbatim with its
 * word count recomputed as the grader will count it, and the rubric the answer
 * will be graded on. `previousFeedback` is the text of the feedback already
-* shown on earlier drafts, so a model can speak to what changed.
+* shown on earlier drafts, so a model can speak to what changed. `group` is the
+* item group the task sits in: its material, the text a summary is of, goes
+* with the request as `material`.
 */
 function aiWritingFeedbackRequest(input) {
 	const { data, response, learnerLocale } = input;
@@ -2222,6 +2325,7 @@ function aiWritingFeedbackRequest(input) {
 		weight: criterion.weight
 	}));
 	const previousFeedback = [...input.previousFeedback ?? []];
+	const material = materialFacts(input.group);
 	return {
 		feature: "writing-feedback",
 		facts: {
@@ -2240,6 +2344,7 @@ function aiWritingFeedbackRequest(input) {
 		},
 		draftNumber: previousFeedback.length + 1,
 		previousFeedback,
+		...material !== null ? { material } : {},
 		...learnerLocale !== void 0 ? { learnerLocale } : {}
 	};
 }
@@ -2539,6 +2644,12 @@ Object.defineProperty(exports, "AI_HINT_TYPES", {
 		return AI_HINT_TYPES;
 	}
 });
+Object.defineProperty(exports, "AI_MATERIAL_MAX_LENGTH", {
+	enumerable: true,
+	get: function() {
+		return AI_MATERIAL_MAX_LENGTH;
+	}
+});
 Object.defineProperty(exports, "AI_TEXT_MAX_LENGTH", {
 	enumerable: true,
 	get: function() {
@@ -2732,4 +2843,4 @@ Object.defineProperty(exports, "validateItemGroupDraft", {
 	}
 });
 
-//# sourceMappingURL=ai-writing-DCVkv4Zj.cjs.map
+//# sourceMappingURL=ai-writing-G6tnCGzw.cjs.map