@intellectif/lk-core 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/CHANGELOG.md +30 -0
  2. package/README.md +4 -3
  3. package/dist/ai-B222dtHH.d.cts +2154 -0
  4. package/dist/ai-B222dtHH.d.cts.map +1 -0
  5. package/dist/ai-B222dtHH.d.ts +2154 -0
  6. package/dist/ai-B222dtHH.d.ts.map +1 -0
  7. package/dist/ai-check.cjs +758 -464
  8. package/dist/ai-check.cjs.map +1 -1
  9. package/dist/ai-check.d.cts +82 -68
  10. package/dist/ai-check.d.cts.map +1 -0
  11. package/dist/ai-check.d.ts +82 -68
  12. package/dist/ai-check.d.ts.map +1 -0
  13. package/dist/ai-check.js +756 -465
  14. package/dist/ai-check.js.map +1 -1
  15. package/dist/ai-writing-CCBjTOM3.js +2496 -0
  16. package/dist/ai-writing-CCBjTOM3.js.map +1 -0
  17. package/dist/ai-writing-DCVkv4Zj.cjs +2735 -0
  18. package/dist/ai-writing-DCVkv4Zj.cjs.map +1 -0
  19. package/dist/{index-DlcqkM_L.d.ts → index-BWPRPIXL.d.ts} +263 -258
  20. package/dist/index-BWPRPIXL.d.ts.map +1 -0
  21. package/dist/index-CXyOV8sm.d.cts +153 -0
  22. package/dist/index-CXyOV8sm.d.cts.map +1 -0
  23. package/dist/index-CegM8o15.d.ts +153 -0
  24. package/dist/index-CegM8o15.d.ts.map +1 -0
  25. package/dist/index-Dyu66R4-.d.cts +1071 -0
  26. package/dist/index-Dyu66R4-.d.cts.map +1 -0
  27. package/dist/{index-DlCW0XaQ.d.cts → index-O4_ExlAD.d.cts} +263 -258
  28. package/dist/index-O4_ExlAD.d.cts.map +1 -0
  29. package/dist/index-UGxRSopE.d.ts +1071 -0
  30. package/dist/index-UGxRSopE.d.ts.map +1 -0
  31. package/dist/index.cjs +1210 -1671
  32. package/dist/index.cjs.map +1 -1
  33. package/dist/index.d.cts +1090 -853
  34. package/dist/index.d.cts.map +1 -0
  35. package/dist/index.d.ts +1090 -853
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +1063 -1672
  38. package/dist/index.js.map +1 -1
  39. package/dist/item-group-DXiR8nOr.js +445 -0
  40. package/dist/item-group-DXiR8nOr.js.map +1 -0
  41. package/dist/item-group-DroFXgLb.cjs +505 -0
  42. package/dist/item-group-DroFXgLb.cjs.map +1 -0
  43. package/dist/registry-DVi0LR_i.cjs +5915 -0
  44. package/dist/registry-DVi0LR_i.cjs.map +1 -0
  45. package/dist/registry-Dsx9mNsS.js +5449 -0
  46. package/dist/registry-Dsx9mNsS.js.map +1 -0
  47. package/dist/schemas-Bdw0nGPo.js +152 -0
  48. package/dist/schemas-Bdw0nGPo.js.map +1 -0
  49. package/dist/schemas-DVbAOrtd.cjs +224 -0
  50. package/dist/schemas-DVbAOrtd.cjs.map +1 -0
  51. package/dist/schemas.cjs +16 -32
  52. package/dist/schemas.d.cts +2 -2
  53. package/dist/schemas.d.ts +2 -2
  54. package/dist/schemas.js +3 -32
  55. package/dist/scoring-B2_HEhMT.cjs +1748 -0
  56. package/dist/scoring-B2_HEhMT.cjs.map +1 -0
  57. package/dist/scoring-BZqUkuDF.js +1604 -0
  58. package/dist/scoring-BZqUkuDF.js.map +1 -0
  59. package/dist/scoring.cjs +37 -75
  60. package/dist/scoring.d.cts +3 -1103
  61. package/dist/scoring.d.ts +3 -1103
  62. package/dist/scoring.js +3 -75
  63. package/dist/xapi-CMTph7wG.js +332 -0
  64. package/dist/xapi-CMTph7wG.js.map +1 -0
  65. package/dist/xapi-DNzkSJ0S.cjs +362 -0
  66. package/dist/xapi-DNzkSJ0S.cjs.map +1 -0
  67. package/dist/xapi.cjs +7 -16
  68. package/dist/xapi.d.cts +2 -150
  69. package/dist/xapi.d.ts +2 -150
  70. package/dist/xapi.js +2 -16
  71. package/package.json +4 -4
  72. package/dist/activity-MBOYLBjR.d.cts +0 -1840
  73. package/dist/activity-MBOYLBjR.d.ts +0 -1840
  74. package/dist/chunk-2JT2WUQ2.cjs +0 -458
  75. package/dist/chunk-2JT2WUQ2.cjs.map +0 -1
  76. package/dist/chunk-DSDXL3JO.cjs +0 -4597
  77. package/dist/chunk-DSDXL3JO.cjs.map +0 -1
  78. package/dist/chunk-FBKTION6.js +0 -4597
  79. package/dist/chunk-FBKTION6.js.map +0 -1
  80. package/dist/chunk-IARLJ5MW.js +0 -1256
  81. package/dist/chunk-IARLJ5MW.js.map +0 -1
  82. package/dist/chunk-LDFQUZII.cjs +0 -950
  83. package/dist/chunk-LDFQUZII.cjs.map +0 -1
  84. package/dist/chunk-NQHETFDA.js +0 -950
  85. package/dist/chunk-NQHETFDA.js.map +0 -1
  86. package/dist/chunk-SJVRUPJT.js +0 -272
  87. package/dist/chunk-SJVRUPJT.js.map +0 -1
  88. package/dist/chunk-TJJFKKH2.cjs +0 -272
  89. package/dist/chunk-TJJFKKH2.cjs.map +0 -1
  90. package/dist/chunk-VSH7ECQL.cjs +0 -1256
  91. package/dist/chunk-VSH7ECQL.cjs.map +0 -1
  92. package/dist/chunk-XS6U2ARZ.js +0 -458
  93. package/dist/chunk-XS6U2ARZ.js.map +0 -1
  94. package/dist/schemas.cjs.map +0 -1
  95. package/dist/schemas.js.map +0 -1
  96. package/dist/scoring.cjs.map +0 -1
  97. package/dist/scoring.js.map +0 -1
  98. package/dist/xapi.cjs.map +0 -1
  99. package/dist/xapi.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/ai-text.ts","../src/ai.ts","../src/ai-coaching.ts","../src/ai-writing.ts"],"sourcesContent":["/**\n * How the SDK reads text a model wrote, before a learner does. Internal: shared\n * by the AI checks, and exported by none of the package's entry points.\n */\n\n/**\n * Plain text as the learner will read it: line endings unified, control\n * characters other than line breaks and tabs removed, runs of blank lines\n * collapsed, the ends trimmed.\n */\nexport function cleanText(text: string): string {\n return (\n text\n .replace(/\\r\\n?/g, '\\n')\n // biome-ignore lint/suspicious/noControlCharactersInRegex: removing them is the point\n .replace(/[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F-\\u009F\\u2028\\u2029]/g, '')\n .replace(/\\n{3,}/g, '\\n\\n')\n .trim()\n );\n}\n","import { cleanText } from './ai-text.js';\nimport { PLACEHOLDER_RE } from './schemas/fill-in-the-blanks.js';\nimport { alignDictation } from './scoring/dictation/align.js';\nimport { isGradeInRange } from './scoring/grade-numbers.js';\nimport { score } from './scoring/index.js';\nimport type {\n ActivityData,\n DictationData,\n FillInTheBlanksData,\n GapSelectData,\n ItemOutcome,\n LearnerResponse,\n MultipleChoiceData,\n ScoringDetail,\n} from './types/activity.js';\nimport type {\n AiActivityInput,\n AiExplanationRequest,\n AiFeature,\n AiGrade,\n AiHintRequest,\n AiItemFacts,\n AiProvenance,\n AiRefusal,\n AiSupportedActivityType,\n AiTextResult,\n AiVerdict,\n AiWordFact,\n} from './types/ai.js';\nimport type { GraderUsage } from './types/grading.js';\n\n/**\n * The activity types the SDK builds facts for, and which of them take hints.\n * A dictation takes none: its answer is the whole sentence, and it has\n * word-by-word hints of its own.\n */\nexport const AI_EXPLANATION_TYPES: readonly AiSupportedActivityType[] = [\n 'multiple-choice',\n 'fill-in-the-blanks',\n 'gap-select',\n 'dictation',\n];\nexport const AI_HINT_TYPES: readonly AiSupportedActivityType[] = [\n 'multiple-choice',\n 'fill-in-the-blanks',\n 'gap-select',\n];\n\n/** The longest AI text shown, in code points. Longer is refused, not cut. */\nexport const AI_TEXT_MAX_LENGTH = 2000;\n\n/**\n * Whether the SDK supports `feature` for this activity type: explanations and\n * hints for the types it builds facts for, and writing feedback for a written\n * response, and coaching for a read-aloud. A consumer's own type has none.\n */\nexport function aiSupports(activityType: string, feature: AiFeature): boolean {\n if (feature === 'writing-feedback') {\n return activityType === 'written-response';\n }\n if (feature === 'pronunciation-coaching') {\n return activityType === 'read-aloud';\n }\n const types = feature === 'hint' ? AI_HINT_TYPES : AI_EXPLANATION_TYPES;\n return (types as readonly string[]).includes(activityType);\n}\n\n/**\n * Whether the item's author allows `feature`. Only an explicit `false`\n * switches it off: an author can refuse a feature, never force one on.\n *\n * Writing feedback and pronunciation coaching read `explanations`: each is a\n * model's words about the learner's own answer, and an author who switched one\n * off has switched off the others.\n */\nexport function aiAllowedByContent(data: AiActivityInput, feature: AiFeature): boolean {\n const permissions = (data as { ai?: unknown }).ai;\n if (typeof permissions !== 'object' || permissions === null) {\n return true;\n }\n const key = feature === 'hint' ? 'hints' : 'explanations';\n return (permissions as Record<string, unknown>)[key] !== false;\n}\n\n/** A grade as an explanation must speak to it: all marks, some, or none. */\nexport function aiGradeOf(result: { score: number; maxScore: number; passed: boolean }): AiGrade {\n const ratio = result.maxScore > 0 ? result.score / result.maxScore : 0;\n let category: AiVerdict = 'partly-correct';\n if (ratio >= 1 - 1e-9) {\n category = 'correct';\n } else if (ratio <= 1e-9) {\n category = 'incorrect';\n }\n return { score: result.score, maxScore: result.maxScore, passed: result.passed, category };\n}\n\n// ── Facts ──────────────────────────────────────────────────────────────\n\n/**\n * The ids of a passage's placeholders, in the order they appear. Read with the\n * schema's own expression, so a passage means here what it means to validation.\n */\nfunction placeholderOrder(passage: string): string[] {\n return [...passage.matchAll(PLACEHOLDER_RE)].map((match) => match[1] as string);\n}\n\n/** The passage with each placeholder written as `[n]`, in passage order. */\nfunction numberedPassage(passage: string): string {\n let position = 0;\n return passage.replace(PLACEHOLDER_RE, () => {\n position += 1;\n return `[${position}]`;\n });\n}\n\n/**\n * The `correct` flag a detail stored before 0.3 carries instead of an\n * `outcome`. On a blank, a gap or a word it meant the part was right; on a\n * multiple-choice option, that the learner acted rightly on it.\n */\nconst legacyCorrect = (detail: ScoringDetail): boolean =>\n (detail as { correct?: unknown }).correct === true;\n\n/** Whether a blank, a gap or a word was right, read from a server's detail. */\nfunction detailRight(detail: ScoringDetail): boolean {\n const outcome: unknown = detail.outcome;\n return outcome === undefined ? legacyCorrect(detail) : outcome === 'correct';\n}\n\n/** Whether an option is part of the answer, read from a server's detail (as the renderer reads it). */\nfunction isAnswerOption(detail: ScoringDetail, chosen: boolean): boolean {\n switch (detail.outcome) {\n case 'correct':\n case 'incorrect-omission':\n return true;\n case 'incorrect':\n case 'correct-omission':\n return false;\n default:\n return chosen ? legacyCorrect(detail) : !legacyCorrect(detail);\n }\n}\n\nconst firstString = (value: string | string[] | undefined): string | undefined =>\n Array.isArray(value) ? value[0] : value;\n\nconst listOf = (value: string | string[] | undefined): string[] | null =>\n value === undefined ? null : Array.isArray(value) ? [...value] : [value];\n\n/** The response a learner has before touching anything. */\nfunction emptyResponse(type: string): LearnerResponse | null {\n switch (type) {\n case 'multiple-choice':\n return { type: 'multiple-choice', selectedOptionIds: [] };\n case 'fill-in-the-blanks':\n return { type: 'fill-in-the-blanks', answers: {} };\n case 'gap-select':\n return { type: 'gap-select', selections: {} };\n case 'dictation':\n return { type: 'dictation', text: '' };\n default:\n return null;\n }\n}\n\nconst base = (data: AiActivityInput) => ({\n activityId: data.id,\n title: data.title,\n ...(typeof data.locale === 'string' ? { locale: data.locale } : {}),\n});\n\n/**\n * The facts a model is given about one item and one answer. `details` are the\n * SDK's per-part verdicts — from its own scorer, or from a server's outcome in\n * review — and every `correct` is `null` without them. A redacted item yields\n * facts without a key, which is what the learner's side holds; a port that\n * needs the key loads the item on its server.\n *\n * `null` for a type the SDK builds no facts for.\n */\nexport function buildAiFacts(\n data: AiActivityInput,\n response: LearnerResponse | null,\n details: readonly ScoringDetail[] | null,\n): AiItemFacts | null {\n const byId = new Map((details ?? []).map((detail) => [detail.itemId, detail]));\n const full = (data as { redacted?: unknown }).redacted !== true;\n switch (data.type) {\n case 'multiple-choice': {\n const item = data as unknown as MultipleChoiceData;\n const chosen = new Set(\n response?.type === 'multiple-choice' ? response.selectedOptionIds : [],\n );\n return {\n ...base(data),\n activityType: 'multiple-choice',\n question: item.question,\n mode: item.mode,\n options: item.options.map((option) => {\n const detail = byId.get(option.id);\n const wasChosen = chosen.has(option.id);\n let correct: boolean | null = null;\n if (full && typeof option.isCorrect === 'boolean') {\n correct = option.isCorrect;\n } else if (detail !== undefined) {\n correct = isAnswerOption(detail, wasChosen);\n }\n return {\n id: option.id,\n text: option.text,\n chosen: wasChosen,\n correct,\n ...(typeof option.feedback === 'string' ? { feedback: option.feedback } : {}),\n };\n }),\n };\n }\n case 'fill-in-the-blanks': {\n const item = data as unknown as FillInTheBlanksData;\n const answers = response?.type === 'fill-in-the-blanks' ? response.answers : {};\n const blanks = new Map(item.blanks.map((blank) => [blank.id, blank]));\n return {\n ...base(data),\n activityType: 'fill-in-the-blanks',\n passage: numberedPassage(item.passage),\n blanks: placeholderOrder(item.passage).map((id, index) => {\n const blank = blanks.get(id);\n const detail = byId.get(id);\n const accepted =\n full && Array.isArray(blank?.acceptedAnswers)\n ? [...blank.acceptedAnswers]\n : listOf(detail?.correctResponse);\n return {\n id,\n position: index + 1,\n typed: typeof answers[id] === 'string' ? (answers[id] as string) : '',\n accepted,\n correct: detail === undefined ? null : detailRight(detail),\n ...(typeof blank?.hint === 'string' ? { hint: blank.hint } : {}),\n ...(typeof blank?.feedback === 'string' ? { feedback: blank.feedback } : {}),\n };\n }),\n };\n }\n case 'gap-select': {\n const item = data as unknown as GapSelectData;\n const selections = response?.type === 'gap-select' ? response.selections : {};\n const gaps = new Map(item.gaps.map((gap) => [gap.id, gap]));\n const banks = new Map((item.banks ?? []).map((bank) => [bank.id, bank]));\n return {\n ...base(data),\n activityType: 'gap-select',\n passage: numberedPassage(item.passage),\n gaps: placeholderOrder(item.passage).map((id, index) => {\n const gap = gaps.get(id);\n const choices =\n gap?.choices ??\n (gap?.bankId === undefined ? [] : (banks.get(gap.bankId)?.choices ?? []));\n const textOf = (choiceId: string | undefined): string | null =>\n choiceId === undefined\n ? null\n : (choices.find((choice) => choice.id === choiceId)?.text ?? null);\n const detail = byId.get(id);\n const answerId =\n full && typeof gap?.correctChoiceId === 'string'\n ? gap.correctChoiceId\n : firstString(detail?.correctResponse);\n return {\n id,\n position: index + 1,\n choices: choices.map((choice) => choice.text),\n chosen: textOf(selections[id]),\n answer: textOf(answerId),\n correct: detail === undefined ? null : detailRight(detail),\n ...(typeof gap?.feedback === 'string' ? { feedback: gap.feedback } : {}),\n };\n }),\n };\n }\n case 'dictation': {\n const item = data as unknown as DictationData;\n const typed = response?.type === 'dictation' ? response.text : '';\n const hasKey = full && typeof item.transcript === 'string';\n let words: AiWordFact[] | null = null;\n if (hasKey) {\n words = alignDictation(item, typed).words.map((word) => ({\n expected: word.reference,\n typed: word.attempt,\n status: word.status,\n }));\n } else if (details !== null && details.length > 0) {\n words = details.map((detail) => {\n const expected = firstString(detail.correctResponse) ?? '';\n const attempt = firstString(detail.learnerResponse) ?? '';\n let status: 'correct' | 'incorrect' | 'missing' | 'extra' = 'incorrect';\n if (detailRight(detail)) {\n status = 'correct';\n } else if (attempt === '') {\n status = 'missing';\n } else if (expected === '') {\n status = 'extra';\n }\n return { expected, typed: attempt, status };\n });\n }\n return {\n ...base(data),\n activityType: 'dictation',\n transcript: hasKey ? item.transcript : null,\n typed,\n words,\n };\n }\n default:\n return null;\n }\n}\n\n/** The SDK's own grade of `response`, with its per-part details; `null` when it cannot grade. */\nfunction gradeLocally(\n data: AiActivityInput,\n response: LearnerResponse,\n): { details: ScoringDetail[]; grade: AiGrade } | null {\n if ((data as { redacted?: unknown }).redacted === true) {\n return null;\n }\n try {\n const result = score(data.type as never, data as unknown as ActivityData, response);\n return { details: result.details, grade: aiGradeOf(result) };\n } catch {\n return null;\n }\n}\n\n/**\n * The request for an explanation of `response`, or `null` when there is none\n * to give: an unsupported type, an author who switched explanations off,\n * nothing graded to explain, or a grade of record that cannot be a grade.\n *\n * A scored `outcome` — the grade of record a review shows — wins over grading\n * locally, so the explanation speaks to the grade on the screen. One whose\n * numbers cannot be a grade (the rule `outcomeFromGrade` applies: `maxScore`\n * positive and finite, `score` finite from 0 to it) gets no explanation at all:\n * explaining 85 \"out of 1\" would tell the model a wrong answer was correct, and\n * grading locally instead would speak to a grade the screen does not show.\n */\nexport function aiExplanationRequest(input: {\n data: AiActivityInput;\n response: LearnerResponse | null;\n outcome?: ItemOutcome;\n learnerLocale?: string;\n}): AiExplanationRequest | null {\n const { data, response, outcome, learnerLocale } = input;\n if (!aiSupports(data.type, 'explanation') || !aiAllowedByContent(data, 'explanation')) {\n return null;\n }\n let details: ScoringDetail[] | null = null;\n let grade: AiGrade | null = null;\n if (outcome?.status === 'scored') {\n // Read once, so the check and the grade handed on see the same numbers.\n const { score: recorded, maxScore, passed } = outcome;\n if (!isGradeInRange(recorded, maxScore)) {\n return null;\n }\n details = outcome.details;\n grade = aiGradeOf({ score: recorded, maxScore, passed });\n } else if (response !== null) {\n const local = gradeLocally(data, response);\n if (local !== null) {\n details = local.details;\n grade = local.grade;\n }\n }\n if (grade === null) {\n return null;\n }\n const facts = buildAiFacts(data, response, details);\n if (facts === null) {\n return null;\n }\n return {\n feature: 'explanation',\n facts,\n grade,\n ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n };\n}\n\n/**\n * The request for the next hint on an unsubmitted answer, or `null` when\n * there is none to give: an unsupported type, an author who switched hints\n * off, or a redacted item — hints are for practice, where the item is whole.\n *\n * The facts carry the key, and which parts the learner has right so far, so a\n * model can hint where it helps. The learner never sees them; a hint that\n * contains an answer is refused by {@link checkAiHint}.\n */\nexport function aiHintRequest(input: {\n data: AiActivityInput;\n response: LearnerResponse | null;\n previousHints: readonly string[];\n learnerLocale?: string;\n}): AiHintRequest | null {\n const { data, previousHints, learnerLocale } = input;\n if (\n !aiSupports(data.type, 'hint') ||\n !aiAllowedByContent(data, 'hint') ||\n (data as { redacted?: unknown }).redacted === true\n ) {\n return null;\n }\n const response = input.response ?? emptyResponse(data.type);\n const local = response === null ? null : gradeLocally(data, response);\n const facts = buildAiFacts(data, response, local?.details ?? null);\n if (facts === null) {\n return null;\n }\n return {\n feature: 'hint',\n facts,\n hintNumber: previousHints.length + 1,\n previousHints: [...previousHints],\n ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n };\n}\n\n// ── Checking what comes back ───────────────────────────────────────────\n\nconst VERDICTS: readonly string[] = ['correct', 'partly-correct', 'incorrect'];\n\n/** A provenance field a host may send, kept only when it is a short string. */\nfunction provenanceOf(raw: unknown): AiProvenance | undefined {\n if (typeof raw !== 'object' || raw === null) {\n return undefined;\n }\n const kept: AiProvenance = {};\n for (const key of ['model', 'promptHash', 'generatedAt'] as const) {\n const value = (raw as Record<string, unknown>)[key];\n if (typeof value === 'string' && value.length > 0 && value.length <= 200) {\n kept[key] = value;\n }\n }\n return Object.keys(kept).length > 0 ? kept : undefined;\n}\n\n/**\n * What the call cost, as a port reported it. Read on the same terms as the\n * provenance: a number that is not finite and zero or more says nothing about\n * a cost, so it is dropped rather than carried into a host's totals.\n */\nfunction usageOf(raw: unknown): GraderUsage | undefined {\n if (typeof raw !== 'object' || raw === null) {\n return undefined;\n }\n const kept: GraderUsage = {};\n for (const key of ['promptTokens', 'completionTokens', 'costUsd'] as const) {\n const value = (raw as Record<string, unknown>)[key];\n if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {\n kept[key] = value;\n }\n }\n return Object.keys(kept).length > 0 ? kept : undefined;\n}\n\n/**\n * Reads what a port returned. Anything but an object with a string `text` is\n * `malformed`; text that is empty once cleaned, or longer than\n * {@link AI_TEXT_MAX_LENGTH}, is refused rather than shown or cut.\n */\nexport function readAiTextResult(\n raw: unknown,\n): { ok: true; result: AiTextResult } | { ok: false; refusal: AiRefusal } {\n if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {\n return { ok: false, refusal: 'malformed' };\n }\n const record = raw as Record<string, unknown>;\n if (typeof record.text !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n if (record.verdict !== undefined && !VERDICTS.includes(record.verdict as string)) {\n return { ok: false, refusal: 'malformed' };\n }\n const text = cleanText(record.text);\n if (text === '') {\n return { ok: false, refusal: 'empty' };\n }\n if ([...text].length > AI_TEXT_MAX_LENGTH) {\n return { ok: false, refusal: 'too-long' };\n }\n const provenance = provenanceOf(record.provenance);\n const usage = usageOf(record.usage);\n return {\n ok: true,\n result: {\n text,\n ...(record.verdict !== undefined ? { verdict: record.verdict as AiVerdict } : {}),\n ...(provenance !== undefined ? { provenance } : {}),\n ...(usage !== undefined ? { usage } : {}),\n },\n };\n}\n\n/**\n * Checks an explanation a port returned for `request`. On top of\n * {@link readAiTextResult}: an explanation that states a verdict other than\n * the SDK's grade is refused (`contradicts-grade`) — it explains an answer\n * the learner did not get.\n */\nexport function checkAiExplanation(\n raw: unknown,\n request: AiExplanationRequest,\n): { ok: true; result: AiTextResult } | { ok: false; refusal: AiRefusal } {\n const read = readAiTextResult(raw);\n if (!read.ok) {\n return read;\n }\n if (read.result.verdict !== undefined && read.result.verdict !== request.grade.category) {\n return { ok: false, refusal: 'contradicts-grade' };\n }\n return read;\n}\n\n/**\n * Checks a hint a port returned for `request`. On top of\n * {@link readAiTextResult}: a hint that contains an answer is refused\n * (`reveals-answer`) — see {@link hintRevealsAnswer}.\n */\nexport function checkAiHint(\n raw: unknown,\n request: AiHintRequest,\n): { ok: true; result: AiTextResult } | { ok: false; refusal: AiRefusal } {\n const read = readAiTextResult(raw);\n if (!read.ok) {\n return read;\n }\n if (hintRevealsAnswer(request.facts, read.result.text)) {\n return { ok: false, refusal: 'reveals-answer' };\n }\n return read;\n}\n\n// ── The answer-leak guard ──────────────────────────────────────────────\n\n/**\n * Text folded for searching: compatibility forms read as what they stand for,\n * accents and other marks removed, lower-cased, and every run of anything but\n * letters and digits turned into one space. \"Está,\" and \"esta\" fold alike.\n */\nfunction fold(text: string): string[] {\n const folded = text\n .normalize('NFKD')\n .replace(/\\p{M}/gu, '')\n .toLowerCase()\n .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\n .trim();\n return folded === '' ? [] : folded.split(' ');\n}\n\n/** Whether `needle` appears in `haystack` as a run of whole words. */\nfunction containsWords(haystack: readonly string[], needle: readonly string[]): boolean {\n if (needle.length === 0 || needle.length > haystack.length) {\n return false;\n }\n for (let start = 0; start + needle.length <= haystack.length; start += 1) {\n let match = true;\n for (let offset = 0; offset < needle.length; offset += 1) {\n if (haystack[start + offset] !== needle[offset]) {\n match = false;\n break;\n }\n }\n if (match) {\n return true;\n }\n }\n return false;\n}\n\n/**\n * An answer too short to search for on its own: one word of fewer than four\n * characters — \"is\", \"the\", \"26\". A hint may use such a word freely; it\n * reveals the answer only when it writes it where the answer goes.\n */\nconst isShort = (words: readonly string[]): boolean =>\n words.length === 1 && [...(words[0] as string)].length < 4;\n\n/**\n * The words either side of the gap numbered `position` in a numbered\n * passage, other gaps left out.\n */\nfunction neighbours(passage: string, position: number): { before?: string; after?: string } {\n const marker = `[${position}]`;\n const at = passage.indexOf(marker);\n if (at === -1) {\n return {};\n }\n const strip = (text: string): string => text.replace(/\\[\\d+\\]/g, ' ');\n const left = fold(strip(passage.slice(0, at)));\n const right = fold(strip(passage.slice(at + marker.length)));\n const before = left[left.length - 1];\n const after = right[0];\n return {\n ...(before !== undefined ? { before } : {}),\n ...(after !== undefined ? { after } : {}),\n };\n}\n\n/**\n * Whether a hint gives away an answer, judged against the facts it was asked\n * for. It is a floor, not a proof: it finds an answer written out, not one\n * spelled letter by letter or described.\n *\n * - **Multiple choice:** the text of any correct option, as whole words.\n * - **Fill-in-the-blanks and gap select:** any accepted answer, as whole words.\n * An answer of one short word (\"is\", \"the\") counts only where the hint\n * writes it beside a neighbour it has in the passage — \"name is\", \"is\n * Rossi\" — so a hint may still use the word on its own.\n *\n * Case, accents and punctuation are ignored on both sides.\n */\nexport function hintRevealsAnswer(facts: AiItemFacts, hint: string): boolean {\n const words = fold(hint);\n const reveals = (answer: string, passage?: string, position?: number): boolean => {\n const needle = fold(answer);\n if (needle.length === 0) {\n return false;\n }\n if (!isShort(needle) || passage === undefined || position === undefined) {\n return containsWords(words, needle);\n }\n const { before, after } = neighbours(passage, position);\n if (before === undefined && after === undefined) {\n return containsWords(words, needle);\n }\n return (\n (before !== undefined && containsWords(words, [before, ...needle])) ||\n (after !== undefined && containsWords(words, [...needle, after]))\n );\n };\n switch (facts.activityType) {\n case 'multiple-choice':\n return facts.options.some((option) => option.correct === true && reveals(option.text));\n case 'fill-in-the-blanks':\n return facts.blanks.some((blank) =>\n (blank.accepted ?? []).some((answer) => reveals(answer, facts.passage, blank.position)),\n );\n case 'gap-select':\n return facts.gaps.some(\n (gap) => gap.answer !== null && reveals(gap.answer, facts.passage, gap.position),\n );\n case 'dictation':\n // Never asked: a dictation takes no AI hints (AI_HINT_TYPES).\n return false;\n default:\n return false;\n }\n}\n","import { aiAllowedByContent, aiSupports, readAiTextResult } from './ai.js';\nimport { cleanText } from './ai-text.js';\nimport { alignReadAloud } from './scoring/speech/align.js';\nimport { validateSpeechAssessment } from './scoring/speech/assessment.js';\nimport type { ReadAloudData } from './types/activity.js';\nimport type {\n AiActivityInput,\n AiCoaching,\n AiCoachingRequest,\n AiReadingFacts,\n AiReadingWordFact,\n AiRefusal,\n AiSoundFact,\n} from './types/ai.js';\nimport type { GradeRecord } from './types/grading.js';\nimport type { SpeechAssessment } from './types/speech.js';\n\n/** The most words one coaching may work on. More is refused, not cut. */\nexport const AI_COACHING_MAX_WORDS = 20;\n\n/** The longest tip for one word, in code points. */\nexport const AI_COACHING_MAX_TIP_LENGTH = 500;\n\n/** The longest sound symbol: a phoneme, not a sentence. */\nconst MAX_SYMBOL_LENGTH = 16;\n\n/** The dimensions a reading is scored on, as the facts name them. */\nconst DIMENSIONS = ['accuracy', 'fluency', 'completeness', 'prosody'] as const;\n\n/** Two decimals: what a stored score out of 1 was, out of 100, without float noise. */\nconst hundredths = (value: number): number => Math.round(value * 10000) / 100;\n\nconst isFiniteNumber = (value: unknown): value is number =>\n typeof value === 'number' && Number.isFinite(value);\n\n/** A word's sounds as the engine reported them: only those it names. */\nfunction soundsOf(word: SpeechAssessment['words'][number] | undefined): AiSoundFact[] | undefined {\n const sounds: AiSoundFact[] = [];\n for (const phoneme of word?.phonemes ?? []) {\n if (typeof phoneme.symbol !== 'string') {\n continue;\n }\n sounds.push({\n symbol: phoneme.symbol,\n ...(phoneme.accuracy !== undefined ? { accuracy: phoneme.accuracy } : {}),\n ...(phoneme.heardAs !== undefined && phoneme.heardAs.length > 0\n ? { heardAs: phoneme.heardAs.map(({ symbol, score }) => ({ symbol, score })) }\n : {}),\n });\n }\n return sounds.length > 0 ? sounds : undefined;\n}\n\n/** The facts from the engine's full assessment: every word's mark, and its sounds. */\nfunction fromAssessment(\n item: ReadAloudData,\n assessment: SpeechAssessment,\n): Pick<AiReadingFacts, 'assessor' | 'phonemeAlphabet' | 'scores' | 'words'> {\n const words: AiReadingWordFact[] = alignReadAloud(item, assessment).map((entry) => {\n const sounds =\n entry.itemId !== undefined && entry.wordIndex !== undefined\n ? soundsOf(assessment.words[entry.wordIndex])\n : undefined;\n return {\n ...(entry.itemId !== undefined ? { itemId: entry.itemId } : {}),\n word: entry.reference,\n heard: entry.heard,\n state: entry.state,\n ...(entry.accuracy !== undefined ? { accuracy: entry.accuracy } : {}),\n ...(sounds !== undefined ? { sounds } : {}),\n };\n });\n const scores: AiReadingFacts['scores'] = {};\n for (const dimension of DIMENSIONS) {\n const value = assessment.scores[dimension];\n if (value !== undefined) {\n scores[dimension] = value;\n }\n }\n return {\n assessor: assessment.assessor.kind,\n ...(assessment.phonemeAlphabet !== undefined\n ? { phonemeAlphabet: assessment.phonemeAlphabet }\n : {}),\n scores,\n words,\n };\n}\n\n/**\n * Whether an assessment holds marks on this text: one `validateSpeechAssessment`\n * accepts, of speech heard, made against the item's own text in its own locale\n * — the checks `gradeReadAloud` makes before it reads a mark. Anything else is\n * not marks on this reading, and would tell a model every word was left out.\n */\nconst marksThisText = (item: ReadAloudData, assessment: SpeechAssessment): boolean =>\n validateSpeechAssessment(assessment).success &&\n assessment.status === 'assessed' &&\n assessment.task === 'scripted' &&\n assessment.locale === item.locale &&\n assessment.referenceText === item.referenceText;\n\nconst STATE_OF_OUTCOME = {\n correct: 'correct',\n incorrect: 'mispronounced',\n 'incorrect-omission': 'omitted',\n} as const;\n\n/**\n * The facts from a stored grade alone: each word's mark and score, and no\n * sounds — a grade's details do not keep them.\n */\nfunction fromGrade(\n grade: GradeRecord,\n): Pick<AiReadingFacts, 'assessor' | 'scores' | 'words'> | null {\n if (!Array.isArray(grade.details) || grade.details.length === 0) {\n return null;\n }\n const words: AiReadingWordFact[] = [];\n for (const detail of grade.details) {\n const state = STATE_OF_OUTCOME[detail.outcome as keyof typeof STATE_OF_OUTCOME];\n if (state === undefined || typeof detail.itemId !== 'string') {\n continue;\n }\n const text = (value: string | string[]): string =>\n Array.isArray(value) ? value.join(' ') : value;\n words.push({\n itemId: detail.itemId,\n word: text(detail.correctResponse),\n heard: text(detail.learnerResponse),\n state,\n ...(state !== 'omitted' && isFiniteNumber(detail.score)\n ? { accuracy: hundredths(detail.score) }\n : {}),\n });\n }\n if (words.length === 0) {\n return null;\n }\n // Each dimension out of 100, whatever scale the grade kept it on. A criterion\n // without a scale to read it on is left out rather than given one.\n const scores: AiReadingFacts['scores'] = {};\n for (const criterion of grade.criteria ?? []) {\n const dimension = DIMENSIONS.find((name) => name === criterion.name);\n if (\n dimension !== undefined &&\n isFiniteNumber(criterion.score) &&\n isFiniteNumber(criterion.maxScore) &&\n criterion.maxScore > 0\n ) {\n scores[dimension] = hundredths(criterion.score / criterion.maxScore);\n }\n }\n const kind = grade.grader?.kind;\n return {\n assessor: kind === 'auto' || kind === 'ai' || kind === 'human' ? kind : 'unknown',\n scores,\n words,\n };\n}\n\n/**\n * The request for coaching on a graded reading, or `null` when there is none\n * to give: not a read-aloud, an author who switched explanations off (coaching\n * reads `ai.explanations`), or no marks.\n *\n * The marks come from the `assessment` when one is given — with each word's\n * sounds and what each was heard as — and then only from it: an assessment\n * `gradeReadAloud` would not read (no speech heard, unscripted, or made against\n * another text or locale) gives none, rather than a stored grade's marks the\n * learner is not looking at. With no assessment, they come from\n * `grade.details`, without sounds.\n *\n * The facts are the text as the learner saw it, those marks word by word, and\n * the engine's dimension scores. The marks are the engine's; the model\n * explains them.\n */\nexport function aiCoachingRequest(input: {\n data: AiActivityInput;\n assessment?: SpeechAssessment | null;\n grade?: GradeRecord | null;\n learnerLocale?: string;\n}): AiCoachingRequest | null {\n const { data, assessment, grade, learnerLocale } = input;\n if (\n !aiSupports(data.type, 'pronunciation-coaching') ||\n !aiAllowedByContent(data, 'pronunciation-coaching')\n ) {\n return null;\n }\n const item = data as unknown as ReadAloudData;\n if (typeof item.referenceText !== 'string' || typeof item.locale !== 'string') {\n return null;\n }\n // An assessment given is the marks, and the only ones: a learner looking at\n // it is not looking at a stored grade's, and coaching must be about what is\n // on screen.\n const marks =\n assessment !== undefined && assessment !== null\n ? marksThisText(item, assessment)\n ? fromAssessment(item, assessment)\n : null\n : grade !== undefined && grade !== null\n ? fromGrade(grade)\n : null;\n if (marks === null) {\n return null;\n }\n const graded =\n grade !== undefined &&\n grade !== null &&\n isFiniteNumber(grade.score) &&\n isFiniteNumber(grade.maxScore) &&\n typeof grade.passed === 'boolean'\n ? { score: grade.score, maxScore: grade.maxScore, passed: grade.passed }\n : undefined;\n return {\n feature: 'pronunciation-coaching',\n facts: {\n activityType: 'read-aloud',\n activityId: data.id,\n title: data.title,\n locale: item.locale,\n referenceText: item.referenceText,\n ...(typeof item.instructions === 'string' ? { instructions: item.instructions } : {}),\n ...marks,\n },\n ...(graded !== undefined ? { grade: graded } : {}),\n ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n };\n}\n\n// ── Checking what comes back ───────────────────────────────────────────\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** A symbol as it is compared: composed, and without the spaces around it. */\nconst symbolKey = (symbol: string): string => symbol.normalize('NFC').trim();\n\ntype Refused = { ok: false; refusal: AiRefusal };\n\n/**\n * Checks coaching a port returned for `request`, and turns it into what a\n * learner is shown. As every AI text, it is shown whole or not at all.\n *\n * - **The text** is read as every AI text is (`readAiTextResult`).\n * - **Every word coached is one the engine marked.** Each `itemId` names a word\n * of the text marked `mispronounced` or `omitted`, once; coaching on a word\n * read correctly, or one the text does not have, refuses the whole reply as\n * `contradicts-marks`. Praise belongs in `text`.\n * - **Every sound named is one the engine reported** for that word, and a sound\n * it was heard as is one the engine heard it as. Where the facts carry no\n * sounds — marks from a stored grade, or an assessor that reports none — any\n * sound is `contradicts-marks`: nothing stands behind it.\n * - **Nothing numeric is read.** A score in the reply is ignored: the marks and\n * the grade are the engine's.\n * - **Limits:** {@link AI_COACHING_MAX_WORDS} words, a tip of\n * {@link AI_COACHING_MAX_TIP_LENGTH} code points; over them `too-long`. A\n * shape that is not the one documented is `malformed`.\n *\n * The words come back in reading order, each with the word as the marks show it\n * (the SDK's reading of the text, never the model's), and each sound spelt as\n * the engine spelt it.\n */\nexport function checkAiCoaching(\n raw: unknown,\n request: AiCoachingRequest,\n): { ok: true; coaching: AiCoaching } | { ok: false; refusal: AiRefusal } {\n const read = readAiTextResult(raw);\n if (!read.ok) {\n return read;\n }\n const entries = (raw as Record<string, unknown>).words;\n const words: (AiCoaching['words'][number] & { order: number })[] = [];\n if (entries !== undefined && entries !== null) {\n if (!Array.isArray(entries)) {\n return { ok: false, refusal: 'malformed' };\n }\n if (entries.length > AI_COACHING_MAX_WORDS) {\n return { ok: false, refusal: 'too-long' };\n }\n const facts = new Map<string, { fact: AiReadingWordFact; order: number }>();\n request.facts.words.forEach((fact, order) => {\n if (fact.itemId !== undefined) {\n facts.set(fact.itemId, { fact, order });\n }\n });\n const seen = new Set<string>();\n for (const entry of entries) {\n if (!isRecord(entry) || typeof entry.itemId !== 'string' || typeof entry.tip !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n const tip = cleanText(entry.tip);\n if (tip === '') {\n return { ok: false, refusal: 'malformed' };\n }\n if ([...tip].length > AI_COACHING_MAX_TIP_LENGTH) {\n return { ok: false, refusal: 'too-long' };\n }\n if (seen.has(entry.itemId)) {\n return { ok: false, refusal: 'malformed' };\n }\n seen.add(entry.itemId);\n const found = facts.get(entry.itemId);\n if (\n found === undefined ||\n (found.fact.state !== 'mispronounced' && found.fact.state !== 'omitted')\n ) {\n return { ok: false, refusal: 'contradicts-marks' };\n }\n const sound = checkSound(entry.sound, found.fact);\n if (sound !== undefined && 'refusal' in sound) {\n return sound;\n }\n words.push({\n itemId: entry.itemId,\n word: found.fact.word,\n tip,\n ...(sound !== undefined ? { sound } : {}),\n order: found.order,\n });\n }\n }\n const { text, provenance, usage } = read.result;\n return {\n ok: true,\n coaching: {\n text,\n words: words.sort((a, b) => a.order - b.order).map(({ order: _order, ...word }) => word),\n ...(provenance !== undefined ? { provenance } : {}),\n ...(usage !== undefined ? { usage } : {}),\n },\n };\n}\n\n/** A sound a model names, checked against the sounds the engine reported for the word. */\nfunction checkSound(\n raw: unknown,\n fact: AiReadingWordFact,\n): { expected: string; heard?: string } | Refused | undefined {\n if (raw === undefined || raw === null) {\n return undefined;\n }\n if (\n !isRecord(raw) ||\n typeof raw.expected !== 'string' ||\n (raw.heard !== undefined && raw.heard !== null && typeof raw.heard !== 'string')\n ) {\n return { ok: false, refusal: 'malformed' };\n }\n const heard = typeof raw.heard === 'string' ? raw.heard : undefined;\n if (\n [...raw.expected].length > MAX_SYMBOL_LENGTH ||\n (heard !== undefined && [...heard].length > MAX_SYMBOL_LENGTH)\n ) {\n return { ok: false, refusal: 'too-long' };\n }\n const expected = symbolKey(raw.expected);\n const reported = fact.sounds?.find((sound) => symbolKey(sound.symbol) === expected);\n if (reported === undefined) {\n return { ok: false, refusal: 'contradicts-marks' };\n }\n if (heard === undefined) {\n return { expected: reported.symbol };\n }\n const instead = reported.heardAs?.find(\n (candidate) => symbolKey(candidate.symbol) === symbolKey(heard),\n );\n if (instead === undefined) {\n return { ok: false, refusal: 'contradicts-marks' };\n }\n return { expected: reported.symbol, heard: instead.symbol };\n}\n","import { aiAllowedByContent, aiSupports, readAiTextResult } from './ai.js';\nimport { cleanText } from './ai-text.js';\nimport { countWords } from './count-words.js';\nimport { gradeFromRubric } from './grading.js';\nimport type { LearnerResponse, WrittenResponseData } from './types/activity.js';\nimport type {\n AiActivityInput,\n AiRefusal,\n AiRubricCriterionFact,\n AiWritingFeedback,\n AiWritingFeedbackRequest,\n} from './types/ai.js';\nimport type { CriterionScore, InlineCorrection } from './types/grading.js';\n\n/** The most corrections one piece of writing feedback may carry. More is refused, not cut. */\nexport const AI_WRITING_MAX_CORRECTIONS = 20;\n\n/** The longest quote, correction, explanation or criterion comment, in code points. */\nexport const AI_WRITING_MAX_FIELD_LENGTH = 500;\n\n/** The longest `category` or `band`: a tag, not a sentence. */\nconst MAX_TAG_LENGTH = 40;\n\n/**\n * The request for feedback on a draft, or `null` when there is none to give:\n * not a written response, an author who switched explanations off (writing\n * feedback reads `ai.explanations`), a redacted item — feedback is for\n * practice, where the item is whole — or a draft with nothing in it.\n *\n * The facts are the task as the learner saw it, the draft verbatim with its\n * word count recomputed as the grader will count it, and the rubric the answer\n * will be graded on. `previousFeedback` is the text of the feedback already\n * shown on earlier drafts, so a model can speak to what changed.\n */\nexport function aiWritingFeedbackRequest(input: {\n data: AiActivityInput;\n response: LearnerResponse | null;\n previousFeedback?: readonly string[];\n learnerLocale?: string;\n}): AiWritingFeedbackRequest | null {\n const { data, response, learnerLocale } = input;\n if (\n !aiSupports(data.type, 'writing-feedback') ||\n !aiAllowedByContent(data, 'writing-feedback') ||\n (data as { redacted?: unknown }).redacted === true\n ) {\n return null;\n }\n const text = response?.type === 'written-response' ? response.text : '';\n if (typeof text !== 'string' || text.trim() === '') {\n return null;\n }\n const item = data as unknown as WrittenResponseData;\n const wordCount = countWords(text);\n const minWords = typeof item.minWords === 'number' ? item.minWords : 0;\n const maxWords = typeof item.maxWords === 'number' ? item.maxWords : Number.POSITIVE_INFINITY;\n const criteria = Array.isArray(item.rubric?.criteria) ? item.rubric.criteria : null;\n const rubric: AiRubricCriterionFact[] | null =\n criteria === null || criteria.length === 0\n ? null\n : criteria.map((criterion) => ({\n name: criterion.name,\n ...(typeof criterion.description === 'string'\n ? { description: criterion.description }\n : {}),\n weight: criterion.weight,\n }));\n const previousFeedback = [...(input.previousFeedback ?? [])];\n return {\n feature: 'writing-feedback',\n facts: {\n activityType: 'written-response',\n activityId: data.id,\n title: data.title,\n ...(typeof data.locale === 'string' ? { locale: data.locale } : {}),\n prompt: typeof item.prompt === 'string' ? item.prompt : '',\n text,\n wordCount,\n minWords,\n maxWords,\n withinWordBounds: wordCount >= minWords && wordCount <= maxWords,\n rubric,\n ...(typeof item.languageTarget === 'string' ? { languageTarget: item.languageTarget } : {}),\n },\n draftNumber: previousFeedback.length + 1,\n previousFeedback,\n ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n };\n}\n\n// ── Finding a quote in the draft ───────────────────────────────────────\n\n/** Typographic quotes a model writes for the plain ones a learner typed, and back. */\nconst QUOTE_FOLD: Readonly<Record<string, string>> = {\n '‘': \"'\",\n '’': \"'\",\n '‛': \"'\",\n '′': \"'\",\n '“': '\"',\n '”': '\"',\n '„': '\"',\n '″': '\"',\n};\n\n/**\n * Text as a quote is matched against it: typographic quotes folded to plain\n * ones and every run of whitespace one space — the two liberties a model takes\n * when it copies words out — with, for each folded character, where it came\n * from, so a match maps back to the learner's own text. Case is kept: a\n * correction of \"i\" to \"I\" is about case.\n */\nfunction folded(text: string): { chars: string; from: number[] } {\n let chars = '';\n const from: number[] = [];\n let space = false;\n for (let at = 0; at < text.length; at += 1) {\n const char = text[at] as string;\n if (/\\s/u.test(char)) {\n if (!space) {\n chars += ' ';\n from.push(at);\n space = true;\n }\n continue;\n }\n space = false;\n chars += QUOTE_FOLD[char] ?? char;\n from.push(at);\n }\n return { chars, from };\n}\n\n/** A quote as it is searched for: folded, and without the spaces around it. */\nconst needle = (quote: string): string => folded(quote).chars.trim();\n\n/**\n * Where `quote` sits in the draft: at `claimed`, when the model named a range —\n * which must then hold the quote — or else at its first occurrence not already\n * taken by an identical quote, so a mistake made twice is anchored twice. A\n * quote corrected more often than it occurs takes its first occurrence again.\n * `null` when the draft does not contain it where claimed, or at all.\n */\nfunction anchor(\n draft: { text: string; chars: string; from: number[] },\n quote: string,\n claimed: { start: number; end: number } | undefined,\n taken: Set<string>,\n): { start: number; end: number } | null {\n const sought = needle(quote);\n if (sought === '') {\n return null;\n }\n if (claimed !== undefined) {\n const { start, end } = claimed;\n if (\n !Number.isSafeInteger(start) ||\n !Number.isSafeInteger(end) ||\n start < 0 ||\n end > draft.text.length ||\n start >= end\n ) {\n return null;\n }\n const span = draft.text.slice(start, end);\n if (needle(span) !== sought) {\n return null;\n }\n // The span, without whitespace the model's range took in at either end.\n const lead = span.length - span.trimStart().length;\n const trail = span.length - span.trimEnd().length;\n return { start: start + lead, end: end - trail };\n }\n let first: { start: number; end: number } | null = null;\n for (let at = draft.chars.indexOf(sought); at !== -1; at = draft.chars.indexOf(sought, at + 1)) {\n const start = draft.from[at] as number;\n const end = (draft.from[at + sought.length - 1] as number) + 1;\n const found = { start, end };\n first ??= found;\n const key = `${start}:${end}`;\n if (!taken.has(key)) {\n taken.add(key);\n return found;\n }\n }\n return first;\n}\n\n// ── Checking what comes back ───────────────────────────────────────────\n\n/** A field that must be a string, at most `max` code points once cleaned; `undefined` when absent. */\nfunction textField(\n value: unknown,\n max: number,\n): { ok: true; value: string | undefined } | { ok: false; refusal: AiRefusal } {\n if (value === undefined || value === null) {\n return { ok: true, value: undefined };\n }\n if (typeof value !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n const cleaned = cleanText(value);\n if ([...cleaned].length > max) {\n return { ok: false, refusal: 'too-long' };\n }\n return { ok: true, value: cleaned === '' ? undefined : cleaned };\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** The corrections, each anchored in the draft, or why the reply is refused. */\nfunction checkCorrections(\n raw: unknown,\n text: string,\n): { ok: true; corrections: InlineCorrection[] } | { ok: false; refusal: AiRefusal } {\n if (raw === undefined || raw === null) {\n return { ok: true, corrections: [] };\n }\n if (!Array.isArray(raw)) {\n return { ok: false, refusal: 'malformed' };\n }\n if (raw.length > AI_WRITING_MAX_CORRECTIONS) {\n return { ok: false, refusal: 'too-long' };\n }\n const draft = { text, ...folded(text) };\n const taken = new Set<string>();\n const corrections: InlineCorrection[] = [];\n for (const entry of raw) {\n if (!isRecord(entry) || typeof entry.original !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n if (typeof entry.corrected !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n if (\n [...entry.original].length > AI_WRITING_MAX_FIELD_LENGTH ||\n [...entry.corrected].length > AI_WRITING_MAX_FIELD_LENGTH\n ) {\n return { ok: false, refusal: 'too-long' };\n }\n // A correction that changes nothing corrects nothing.\n if (needle(entry.original) === needle(entry.corrected)) {\n return { ok: false, refusal: 'malformed' };\n }\n const explanation = textField(entry.explanation, AI_WRITING_MAX_FIELD_LENGTH);\n const category = textField(entry.category, MAX_TAG_LENGTH);\n if (!explanation.ok) {\n return explanation;\n }\n if (!category.ok) {\n return category;\n }\n let claimed: { start: number; end: number } | undefined;\n if (entry.range !== undefined && entry.range !== null) {\n if (!isRecord(entry.range)) {\n return { ok: false, refusal: 'malformed' };\n }\n claimed = { start: entry.range.start as number, end: entry.range.end as number };\n }\n const at = anchor(draft, entry.original, claimed, taken);\n if (at === null) {\n return { ok: false, refusal: 'misquotes-answer' };\n }\n corrections.push({\n original: text.slice(at.start, at.end),\n corrected: cleanText(entry.corrected),\n ...(explanation.value !== undefined ? { explanation: explanation.value } : {}),\n ...(category.value !== undefined ? { category: category.value } : {}),\n range: at,\n });\n }\n return { ok: true, corrections };\n}\n\n/** A criterion score a grade could be computed from: finite, 0 or more, and not above its maximum. */\nfunction isJudgedScore(score: unknown, maxScore: unknown): boolean {\n if (score === undefined) {\n return maxScore === undefined || (typeof maxScore === 'number' && maxScore > 0);\n }\n const max = maxScore ?? 1;\n return (\n typeof score === 'number' &&\n typeof max === 'number' &&\n Number.isFinite(score) &&\n Number.isFinite(max) &&\n max > 0 &&\n score >= 0 &&\n score - max <= max * 1e-9\n );\n}\n\n/** The judgements, each on a criterion the author wrote and weighted as the author weighted it. */\nfunction checkCriteria(\n raw: unknown,\n rubric: readonly AiRubricCriterionFact[] | null,\n): { ok: true; criteria: CriterionScore[] } | { ok: false; refusal: AiRefusal } {\n if (raw === undefined || raw === null) {\n return { ok: true, criteria: [] };\n }\n if (!Array.isArray(raw)) {\n return { ok: false, refusal: 'malformed' };\n }\n if (raw.length === 0) {\n return { ok: true, criteria: [] };\n }\n // Judging a criterion the author did not write is judging a different task.\n if (rubric === null) {\n return { ok: false, refusal: 'malformed' };\n }\n const weights = new Map(rubric.map((criterion) => [criterion.name, criterion.weight]));\n const seen = new Set<string>();\n const criteria: CriterionScore[] = [];\n for (const entry of raw) {\n if (!isRecord(entry) || typeof entry.name !== 'string') {\n return { ok: false, refusal: 'malformed' };\n }\n const weight = weights.get(entry.name);\n if (weight === undefined || seen.has(entry.name)) {\n return { ok: false, refusal: 'malformed' };\n }\n seen.add(entry.name);\n if (!isJudgedScore(entry.score, entry.maxScore)) {\n return { ok: false, refusal: 'malformed' };\n }\n if (entry.notApplicable !== undefined && typeof entry.notApplicable !== 'boolean') {\n return { ok: false, refusal: 'malformed' };\n }\n const band = textField(entry.band, MAX_TAG_LENGTH);\n const comment = textField(entry.comment, AI_WRITING_MAX_FIELD_LENGTH);\n if (!band.ok) {\n return band;\n }\n if (!comment.ok) {\n return comment;\n }\n criteria.push({\n name: entry.name,\n ...(typeof entry.score === 'number' ? { score: entry.score } : {}),\n ...(typeof entry.maxScore === 'number' ? { maxScore: entry.maxScore } : {}),\n ...(band.value !== undefined ? { band: band.value } : {}),\n ...(comment.value !== undefined ? { comment: comment.value } : {}),\n ...(entry.notApplicable === true ? { notApplicable: true } : {}),\n weight,\n });\n }\n return { ok: true, criteria };\n}\n\n/**\n * Checks writing feedback a port returned for `request`, and turns it into what\n * a learner is shown. The SDK shows a model's feedback whole or not at all: it\n * never drops the part it doubts and shows the rest.\n *\n * - **The text** is read as every AI text is (`readAiTextResult`): plain text,\n * not empty, at most {@link AI_TEXT_MAX_LENGTH} code points.\n * - **Every correction must quote the draft** — the check only this SDK can run.\n * The SDK finds each quote in the draft itself, typographic quotes and runs of\n * whitespace aside, and anchors it there; a range the model claims must hold\n * the quote. A correction of words the learner did not write refuses the\n * whole reply as `misquotes-answer`, as a hint that gives the answer away\n * refuses the hint. The `original` shown is the draft's own text at the range.\n * At most {@link AI_WRITING_MAX_CORRECTIONS}; a correction that changes\n * nothing is `malformed`.\n * - **Criteria are judgements; the arithmetic is the SDK's.** Each names a\n * criterion of the item's rubric, once; its score, when it has one, is a\n * score out of its `maxScore`. The rubric's weights are attached, whatever\n * the model sent. Anything else is `malformed`, as is any criterion on an\n * item with no rubric.\n * - **`indicativeScore`** is the rubric's weighted total, computed as\n * `gradeFromRubric` computes a grade, when every criterion of the rubric was\n * judged; `null` otherwise. An indication, never a grade.\n */\nexport function checkAiWritingFeedback(\n raw: unknown,\n request: AiWritingFeedbackRequest,\n): { ok: true; feedback: AiWritingFeedback } | { ok: false; refusal: AiRefusal } {\n const read = readAiTextResult(raw);\n if (!read.ok) {\n return read;\n }\n const record = raw as Record<string, unknown>;\n const corrections = checkCorrections(record.corrections, request.facts.text);\n if (!corrections.ok) {\n return corrections;\n }\n const rubric = request.facts.rubric;\n const criteria = checkCriteria(record.criteria, rubric);\n if (!criteria.ok) {\n return criteria;\n }\n let indicativeScore: number | null = null;\n const judged = new Set(criteria.criteria.map((criterion) => criterion.name));\n if (rubric?.every((criterion) => judged.has(criterion.name))) {\n const grade = gradeFromRubric(criteria.criteria);\n indicativeScore = 'unscorable' in grade ? null : grade.score;\n }\n const { text, provenance, usage } = read.result;\n return {\n ok: true,\n feedback: {\n text,\n corrections: corrections.corrections,\n criteria: criteria.criteria,\n indicativeScore,\n ...(provenance !== undefined ? { provenance } : {}),\n ...(usage !== undefined ? { usage } : {}),\n },\n };\n}\n"],"mappings":"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","names":["folded","needle","score","isRecord","score"]}
@@ -1,272 +0,0 @@
1
- import {
2
- ActivitySchemaError,
3
- getActivityTypeDescriptor
4
- } from "./chunk-FBKTION6.js";
5
-
6
- // src/xapi/validators.ts
7
- import { z } from "zod/v4";
8
- var UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
9
- var IRI = /^[a-z][a-z0-9+.-]*:/i;
10
- var langMap = z.record(z.string(), z.string());
11
- var extensions = z.record(z.string(), z.unknown());
12
- var actorSchema = z.object({
13
- objectType: z.literal("Agent"),
14
- name: z.string().optional(),
15
- mbox: z.string().regex(/^mailto:/, "mbox must be a mailto IRI").optional(),
16
- account: z.object({ homePage: z.string(), name: z.string() }).optional()
17
- }).refine((actor) => actor.mbox !== void 0 || actor.account !== void 0, {
18
- error: "actor must be identified by an mbox or an account"
19
- });
20
- var statementSchema = z.object({
21
- id: z.string().regex(UUID_V4, "id must be a UUID v4"),
22
- actor: actorSchema,
23
- verb: z.object({
24
- id: z.string().regex(IRI, "verb.id must be an IRI"),
25
- display: langMap
26
- }),
27
- object: z.object({
28
- objectType: z.literal("Activity"),
29
- id: z.string().regex(IRI, "object.id must be an IRI"),
30
- definition: z.object({
31
- name: langMap.optional(),
32
- description: langMap.optional(),
33
- type: z.string().optional(),
34
- interactionType: z.string().optional(),
35
- correctResponsesPattern: z.array(z.string()).optional(),
36
- choices: z.array(z.object({ id: z.string(), description: langMap.optional() })).optional(),
37
- extensions: extensions.optional()
38
- }).optional()
39
- }),
40
- result: z.object({
41
- // xAPI 1.0.3 permits scaled in [-1, 1]; the SDK only emits [0, 1].
42
- score: z.object({
43
- scaled: z.number().min(-1).max(1),
44
- raw: z.number().optional(),
45
- min: z.number().optional(),
46
- max: z.number().optional()
47
- }).optional(),
48
- success: z.boolean().optional(),
49
- completion: z.boolean().optional(),
50
- duration: z.string().regex(/^P/, "duration must be an ISO 8601 duration").optional(),
51
- response: z.string().optional(),
52
- extensions: extensions.optional()
53
- }).optional(),
54
- context: z.object({
55
- platform: z.string().optional(),
56
- language: z.string().optional(),
57
- contextActivities: z.object({
58
- parent: z.array(z.object({ objectType: z.literal("Activity"), id: z.string() })).optional(),
59
- grouping: z.array(z.object({ objectType: z.literal("Activity"), id: z.string() })).optional(),
60
- category: z.array(z.object({ objectType: z.literal("Activity"), id: z.string() })).optional(),
61
- other: z.array(z.object({ objectType: z.literal("Activity"), id: z.string() })).optional()
62
- }).optional(),
63
- extensions: extensions.optional()
64
- }).optional(),
65
- timestamp: z.string().refine((value) => !Number.isNaN(Date.parse(value)), "timestamp must be ISO 8601"),
66
- version: z.literal("1.0.3")
67
- });
68
- function isProduction() {
69
- try {
70
- return process.env.NODE_ENV === "production";
71
- } catch {
72
- return false;
73
- }
74
- }
75
- function validateXAPIStatement(statement) {
76
- const result = statementSchema.safeParse(statement);
77
- if (result.success) {
78
- return;
79
- }
80
- const errors = result.error.issues.map((issue) => ({
81
- path: issue.path.map(String),
82
- message: issue.message,
83
- code: issue.code
84
- }));
85
- if (isProduction()) {
86
- console.warn("[learning-kit] Invalid xAPI statement (sent anyway):", errors);
87
- return;
88
- }
89
- throw new ActivitySchemaError("xAPIStatement", errors);
90
- }
91
-
92
- // src/xapi/verbs.ts
93
- var XAPIVerb = {
94
- ANSWERED: "http://adlnet.gov/expapi/verbs/answered",
95
- COMPLETED: "http://adlnet.gov/expapi/verbs/completed",
96
- EXPERIENCED: "http://adlnet.gov/expapi/verbs/experienced",
97
- INTERACTED: "http://adlnet.gov/expapi/verbs/interacted",
98
- ATTEMPTED: "http://adlnet.gov/expapi/verbs/attempted",
99
- PASSED: "http://adlnet.gov/expapi/verbs/passed",
100
- FAILED: "http://adlnet.gov/expapi/verbs/failed",
101
- WATCHED: "https://w3id.org/xapi/video/verbs/watched",
102
- /**
103
- * Emitted for deferred-grading submissions (e.g. written-response): the
104
- * learner has submitted work whose grade does not exist yet, so `answered`
105
- * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no
106
- * canonical "submit" verb; the Activity Streams 1.0 IRI is the established
107
- * community choice (design decision recorded per Task 25.4).
108
- */
109
- SUBMITTED: "http://activitystrea.ms/schema/1.0/submit",
110
- /**
111
- * Emitted when an asynchronous grader produces a grade for work that was
112
- * previously only SUBMITTED. Distinct from `answered`, which asserts the
113
- * grade existed at submission time — here the learner acted earlier and the
114
- * grade arrived later, often from a different actor (an AI or a teacher).
115
- */
116
- SCORED: "http://adlnet.gov/expapi/verbs/scored"
117
- };
118
- var XAPI_VERB_DISPLAY = {
119
- ANSWERED: { "en-US": "answered" },
120
- COMPLETED: { "en-US": "completed" },
121
- EXPERIENCED: { "en-US": "experienced" },
122
- INTERACTED: { "en-US": "interacted" },
123
- ATTEMPTED: { "en-US": "attempted" },
124
- PASSED: { "en-US": "passed" },
125
- FAILED: { "en-US": "failed" },
126
- WATCHED: { "en-US": "watched" },
127
- SUBMITTED: { "en-US": "submitted" },
128
- SCORED: { "en-US": "scored" }
129
- };
130
-
131
- // src/xapi/builder.ts
132
- function msToIsoDuration(ms) {
133
- return `PT${(Math.round(Math.max(0, ms) / 10) / 100).toFixed(2)}S`;
134
- }
135
- function uuidv4() {
136
- const c = globalThis.crypto;
137
- if (c?.randomUUID) {
138
- return c.randomUUID();
139
- }
140
- const bytes = new Uint8Array(16);
141
- if (c?.getRandomValues) {
142
- c.getRandomValues(bytes);
143
- } else {
144
- for (let i = 0; i < 16; i += 1) {
145
- bytes[i] = Math.floor(Math.random() * 256);
146
- }
147
- }
148
- bytes[6] = bytes[6] & 15 | 64;
149
- bytes[8] = bytes[8] & 63 | 128;
150
- const hex = [...bytes].map((b) => b.toString(16).padStart(2, "0")).join("");
151
- return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
152
- }
153
- function buildObject(params) {
154
- const definition = {
155
- ...params.name !== void 0 ? { name: params.name } : {},
156
- ...params.description !== void 0 ? { description: params.description } : {},
157
- ...params.type !== void 0 ? { type: params.type } : {},
158
- ...params.interactionType !== void 0 ? { interactionType: params.interactionType } : {},
159
- ...params.correctResponsesPattern !== void 0 ? { correctResponsesPattern: params.correctResponsesPattern } : {},
160
- ...params.choices !== void 0 ? { choices: params.choices } : {}
161
- };
162
- return {
163
- objectType: "Activity",
164
- id: params.id,
165
- ...Object.keys(definition).length > 0 ? { definition } : {}
166
- };
167
- }
168
- function buildResult(timeSpentMs, scoringResult, resultExtensions, response) {
169
- return {
170
- completion: true,
171
- duration: msToIsoDuration(timeSpentMs),
172
- ...scoringResult !== void 0 ? {
173
- score: {
174
- scaled: scoringResult.score,
175
- raw: scoringResult.score,
176
- min: 0,
177
- max: scoringResult.maxScore
178
- },
179
- success: scoringResult.passed
180
- } : {},
181
- ...response !== void 0 ? { response } : {},
182
- ...resultExtensions !== void 0 ? { extensions: resultExtensions } : {}
183
- };
184
- }
185
- var xAPIBuilder = {
186
- buildStatement(params) {
187
- const statement = {
188
- id: uuidv4(),
189
- actor: params.actor,
190
- verb: {
191
- id: XAPIVerb[params.verb],
192
- display: XAPI_VERB_DISPLAY[params.verb]
193
- },
194
- object: buildObject(params.object),
195
- ...params.result !== void 0 ? { result: params.result } : {},
196
- ...params.context !== void 0 ? { context: params.context } : {},
197
- timestamp: (/* @__PURE__ */ new Date()).toISOString(),
198
- version: "1.0.3"
199
- };
200
- validateXAPIStatement(statement);
201
- return statement;
202
- },
203
- buildAnsweredStatement(params) {
204
- return this.buildStatement({
205
- actor: params.actor,
206
- verb: "ANSWERED",
207
- object: params.object,
208
- result: buildResult(
209
- params.timeSpentMs,
210
- params.scoringResult,
211
- params.resultExtensions,
212
- params.response
213
- ),
214
- ...params.context !== void 0 ? { context: params.context } : {}
215
- });
216
- },
217
- /**
218
- * Builds a statement for a deferred-grading submission (e.g. a written
219
- * response). Verb is SUBMITTED and the result deliberately omits `score`,
220
- * `success`, and `completion` — none of them exist until the asynchronous
221
- * grader runs; only `duration`, `response`, and extensions are recorded.
222
- */
223
- buildSubmittedStatement(params) {
224
- return this.buildStatement({
225
- actor: params.actor,
226
- verb: "SUBMITTED",
227
- object: params.object,
228
- result: {
229
- duration: msToIsoDuration(params.timeSpentMs),
230
- ...params.response !== void 0 ? { response: params.response } : {},
231
- ...params.resultExtensions !== void 0 ? { extensions: params.resultExtensions } : {}
232
- },
233
- ...params.context !== void 0 ? { context: params.context } : {}
234
- });
235
- },
236
- buildCompletedStatement(params) {
237
- return this.buildStatement({
238
- actor: params.actor,
239
- verb: "COMPLETED",
240
- object: params.object,
241
- result: buildResult(
242
- params.timeSpentMs,
243
- params.scoringResult,
244
- params.resultExtensions,
245
- void 0
246
- ),
247
- ...params.context !== void 0 ? { context: params.context } : {}
248
- });
249
- }
250
- };
251
- function xapiDefinitionFor(data) {
252
- const descriptor = getActivityTypeDescriptor(data.type);
253
- const interop = descriptor?.interop;
254
- if (interop === void 0) {
255
- return {};
256
- }
257
- const pattern = interop.correctResponsesPattern?.(data);
258
- return {
259
- ...interop.xapiActivityTypeIri !== void 0 ? { type: interop.xapiActivityTypeIri } : {},
260
- ...interop.xapiInteractionType !== void 0 ? { interactionType: interop.xapiInteractionType } : {},
261
- ...pattern !== void 0 && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}
262
- };
263
- }
264
-
265
- export {
266
- validateXAPIStatement,
267
- XAPIVerb,
268
- XAPI_VERB_DISPLAY,
269
- xAPIBuilder,
270
- xapiDefinitionFor
271
- };
272
- //# sourceMappingURL=chunk-SJVRUPJT.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"sourcesContent":["import { z } from 'zod/v4';\nimport { ActivitySchemaError } from '../errors.js';\nimport type { ValidationError } from '../types/activity.js';\nimport type { XAPIStatement } from '../types/xapi.js';\n\nconst UUID_V4 = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n// Minimal IRI/URI check: a scheme followed by ':'.\nconst IRI = /^[a-z][a-z0-9+.-]*:/i;\n\nconst langMap = z.record(z.string(), z.string());\nconst extensions = z.record(z.string(), z.unknown());\n\nconst actorSchema = z\n .object({\n objectType: z.literal('Agent'),\n name: z.string().optional(),\n mbox: z\n .string()\n .regex(/^mailto:/, 'mbox must be a mailto IRI')\n .optional(),\n account: z.object({ homePage: z.string(), name: z.string() }).optional(),\n })\n .refine((actor) => actor.mbox !== undefined || actor.account !== undefined, {\n error: 'actor must be identified by an mbox or an account',\n });\n\nconst statementSchema = z.object({\n id: z.string().regex(UUID_V4, 'id must be a UUID v4'),\n actor: actorSchema,\n verb: z.object({\n id: z.string().regex(IRI, 'verb.id must be an IRI'),\n display: langMap,\n }),\n object: z.object({\n objectType: z.literal('Activity'),\n id: z.string().regex(IRI, 'object.id must be an IRI'),\n definition: z\n .object({\n name: langMap.optional(),\n description: langMap.optional(),\n type: z.string().optional(),\n interactionType: z.string().optional(),\n correctResponsesPattern: z.array(z.string()).optional(),\n choices: z.array(z.object({ id: z.string(), description: langMap.optional() })).optional(),\n extensions: extensions.optional(),\n })\n .optional(),\n }),\n result: z\n .object({\n // xAPI 1.0.3 permits scaled in [-1, 1]; the SDK only emits [0, 1].\n score: z\n .object({\n scaled: z.number().min(-1).max(1),\n raw: z.number().optional(),\n min: z.number().optional(),\n max: z.number().optional(),\n })\n .optional(),\n success: z.boolean().optional(),\n completion: z.boolean().optional(),\n duration: z.string().regex(/^P/, 'duration must be an ISO 8601 duration').optional(),\n response: z.string().optional(),\n extensions: extensions.optional(),\n })\n .optional(),\n context: z\n .object({\n platform: z.string().optional(),\n language: z.string().optional(),\n contextActivities: z\n .object({\n parent: z\n .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n .optional(),\n grouping: z\n .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n .optional(),\n category: z\n .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n .optional(),\n other: z\n .array(z.object({ objectType: z.literal('Activity'), id: z.string() }))\n .optional(),\n })\n .optional(),\n extensions: extensions.optional(),\n })\n .optional(),\n timestamp: z\n .string()\n .refine((value) => !Number.isNaN(Date.parse(value)), 'timestamp must be ISO 8601'),\n version: z.literal('1.0.3'),\n});\n\n/**\n * The one global this module reads by name. Declared here, not globally: this\n * package compiles without Node's types on purpose, and nothing else in it may\n * come to rely on `process`.\n */\ndeclare const process: { env: { NODE_ENV?: string } };\n\n/**\n * Whether this is a production build.\n *\n * **The literal `process.env.NODE_ENV`, spelled exactly so.** It is the one\n * expression bundlers replace at build time, and a browser has no `process` to\n * read at run time. The reading this replaces,\n * `globalThis.process?.env?.NODE_ENV`, is not that expression, so no bundler\n * touched it, and in a browser it found no `process` and answered \"not\n * production\" in every production app — so a malformed statement threw there\n * instead of being logged and sent. Tests running in Node never saw it,\n * because Node has a `process`.\n *\n * This package's own build must leave the literal in its output, for the\n * consumer's bundler to replace. The `try` covers code that reaches a runtime\n * unbundled, with no `process` at all: that is not production, as it always\n * was.\n */\nfunction isProduction(): boolean {\n try {\n return process.env.NODE_ENV === 'production';\n } catch {\n return false;\n }\n}\n\n/**\n * Validates a constructed {@link XAPIStatement} against the xAPI 1.0.3\n * structural contract.\n *\n * In development a structural failure throws (caught early); in production it\n * logs a warning and returns (the statement is still sent — see the design's\n * Error Handling table). Uses a `zod/v4` schema rather than `ajv` + an\n * external JSON Schema to keep `lk-core` dependency-free.\n *\n * NOTE: `ActivitySchemaError` is reused here per the task spec; its\n * `activityType` field carries the sentinel `'xAPIStatement'`. A dedicated\n * `XAPIValidationError` would be semantically cleaner — flagged for review.\n */\nexport function validateXAPIStatement(statement: XAPIStatement): void {\n const result = statementSchema.safeParse(statement);\n if (result.success) {\n return;\n }\n\n const errors: ValidationError[] = result.error.issues.map((issue) => ({\n path: issue.path.map(String),\n message: issue.message,\n code: issue.code,\n }));\n\n if (isProduction()) {\n console.warn('[learning-kit] Invalid xAPI statement (sent anyway):', errors);\n return;\n }\n\n throw new ActivitySchemaError('xAPIStatement', errors);\n}\n","/**\n * The set of xAPI verbs emitted by SDK activities, keyed by a stable\n * identifier mapped to its canonical xAPI verb IRI (xAPI 1.0.3 / ADL registry).\n */\nexport const XAPIVerb = {\n ANSWERED: 'http://adlnet.gov/expapi/verbs/answered',\n COMPLETED: 'http://adlnet.gov/expapi/verbs/completed',\n EXPERIENCED: 'http://adlnet.gov/expapi/verbs/experienced',\n INTERACTED: 'http://adlnet.gov/expapi/verbs/interacted',\n ATTEMPTED: 'http://adlnet.gov/expapi/verbs/attempted',\n PASSED: 'http://adlnet.gov/expapi/verbs/passed',\n FAILED: 'http://adlnet.gov/expapi/verbs/failed',\n WATCHED: 'https://w3id.org/xapi/video/verbs/watched',\n /**\n * Emitted for deferred-grading submissions (e.g. written-response): the\n * learner has submitted work whose grade does not exist yet, so `answered`\n * (which implies a scored response) would be wrong. xAPI 1.0.3 defines no\n * canonical \"submit\" verb; the Activity Streams 1.0 IRI is the established\n * community choice (design decision recorded per Task 25.4).\n */\n SUBMITTED: 'http://activitystrea.ms/schema/1.0/submit',\n /**\n * Emitted when an asynchronous grader produces a grade for work that was\n * previously only SUBMITTED. Distinct from `answered`, which asserts the\n * grade existed at submission time — here the learner acted earlier and the\n * grade arrived later, often from a different actor (an AI or a teacher).\n */\n SCORED: 'http://adlnet.gov/expapi/verbs/scored',\n} as const;\n\n/** Union of the valid `XAPIVerb` keys. */\nexport type XAPIVerbKey = keyof typeof XAPIVerb;\n\n/**\n * Default `en-US` display label for each verb, used to populate\n * `XAPIVerbObject.display` when the builder resolves a verb key.\n */\nexport const XAPI_VERB_DISPLAY: Record<XAPIVerbKey, Record<string, string>> = {\n ANSWERED: { 'en-US': 'answered' },\n COMPLETED: { 'en-US': 'completed' },\n EXPERIENCED: { 'en-US': 'experienced' },\n INTERACTED: { 'en-US': 'interacted' },\n ATTEMPTED: { 'en-US': 'attempted' },\n PASSED: { 'en-US': 'passed' },\n FAILED: { 'en-US': 'failed' },\n WATCHED: { 'en-US': 'watched' },\n SUBMITTED: { 'en-US': 'submitted' },\n SCORED: { 'en-US': 'scored' },\n};\n","import { getActivityTypeDescriptor } from '../registry/index.js';\nimport type { ScoringResult } from '../types/activity.js';\nimport type {\n XAPIActor,\n XAPIContext,\n XAPIObject,\n XAPIResult,\n XAPIStatement,\n} from '../types/xapi.js';\nimport { validateXAPIStatement } from './validators.js';\nimport { XAPI_VERB_DISPLAY, XAPIVerb, type XAPIVerbKey } from './verbs.js';\n\n/** Caller-supplied activity object descriptor (mapped to an xAPI Activity). */\nexport interface XAPIObjectParams {\n /** Activity IRI. */\n id: string;\n name?: Record<string, string>;\n description?: Record<string, string>;\n /** Activity type IRI. */\n type?: string;\n /** xAPI cmi.interaction type (e.g. `choice`, `fill-in`, `long-fill-in`). */\n interactionType?: string;\n /** Correct-responses patterns, per the xAPI CRP format. */\n correctResponsesPattern?: string[];\n /** For choice-family interactions: the available components. */\n choices?: Array<{ id: string; description?: Record<string, string> }>;\n}\n\n/** Parameters for the generic {@link xAPIBuilder.buildStatement}. */\nexport interface XAPIStatementParams {\n actor: XAPIActor;\n verb: XAPIVerbKey;\n object: XAPIObjectParams;\n result?: XAPIResult;\n context?: XAPIContext;\n}\n\n/** Parameters for {@link xAPIBuilder.buildAnsweredStatement} (verb = ANSWERED). */\nexport interface AnsweredStatementParams {\n actor: XAPIActor;\n object: XAPIObjectParams;\n scoringResult: ScoringResult;\n timeSpentMs: number;\n /** Serialized learner response string. */\n response?: string;\n context?: XAPIContext;\n resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Parameters for {@link xAPIBuilder.buildSubmittedStatement} (verb =\n * SUBMITTED — deferred-grading submissions). Carries NO score, success, or\n * completion: the grade does not exist yet (Req 22.7).\n */\nexport interface SubmittedStatementParams {\n actor: XAPIActor;\n object: XAPIObjectParams;\n timeSpentMs: number;\n /** Serialized learner response string (e.g. the submitted text). */\n response?: string;\n context?: XAPIContext;\n resultExtensions?: Record<string, unknown>;\n}\n\n/** Parameters for {@link xAPIBuilder.buildCompletedStatement} (verb = COMPLETED). */\nexport interface CompletedStatementParams {\n actor: XAPIActor;\n object: XAPIObjectParams;\n scoringResult?: ScoringResult;\n timeSpentMs: number;\n context?: XAPIContext;\n resultExtensions?: Record<string, unknown>;\n}\n\n/**\n * Converts a millisecond duration to an ISO 8601 seconds string with\n * centisecond precision (`PT1.23S`), per the xAPI 1.0.3 recommendation of\n * 0.01-second accuracy. Sub-second durations are preserved (previously any\n * duration under 500 ms collapsed to `PT0S`). Negative inputs (clock skew)\n * clamp to zero — a negative ISO duration is invalid.\n */\nfunction msToIsoDuration(ms: number): string {\n return `PT${(Math.round(Math.max(0, ms) / 10) / 100).toFixed(2)}S`;\n}\n\n/**\n * UUID v4 that works outside secure contexts. `crypto.randomUUID` is\n * SecureContext-gated (undefined on plain-http LAN/staging origins), and a\n * statement is built at SUBMIT time — throwing here would lose the learner's\n * answer. `crypto.getRandomValues` is NOT gated, so the fallback still emits\n * a spec-valid v4 UUID (the statement validator enforces the v4 format).\n */\nfunction uuidv4(): string {\n const c = (\n globalThis as {\n crypto?: { randomUUID?: () => string; getRandomValues?: (a: Uint8Array) => Uint8Array };\n }\n ).crypto;\n if (c?.randomUUID) {\n return c.randomUUID();\n }\n const bytes = new Uint8Array(16);\n if (c?.getRandomValues) {\n c.getRandomValues(bytes);\n } else {\n for (let i = 0; i < 16; i += 1) {\n bytes[i] = Math.floor(Math.random() * 256);\n }\n }\n bytes[6] = ((bytes[6] as number) & 0x0f) | 0x40;\n bytes[8] = ((bytes[8] as number) & 0x3f) | 0x80;\n const hex = [...bytes].map((b) => b.toString(16).padStart(2, '0')).join('');\n return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/** Builds the xAPI Activity object, including `definition` only when populated. */\nfunction buildObject(params: XAPIObjectParams): XAPIObject {\n const definition: NonNullable<XAPIObject['definition']> = {\n ...(params.name !== undefined ? { name: params.name } : {}),\n ...(params.description !== undefined ? { description: params.description } : {}),\n ...(params.type !== undefined ? { type: params.type } : {}),\n ...(params.interactionType !== undefined ? { interactionType: params.interactionType } : {}),\n ...(params.correctResponsesPattern !== undefined\n ? { correctResponsesPattern: params.correctResponsesPattern }\n : {}),\n ...(params.choices !== undefined ? { choices: params.choices } : {}),\n };\n return {\n objectType: 'Activity',\n id: params.id,\n ...(Object.keys(definition).length > 0 ? { definition } : {}),\n };\n}\n\n/**\n * Maps a {@link ScoringResult} + timing to an {@link XAPIResult} per the\n * normative mapping in the design document.\n */\nfunction buildResult(\n timeSpentMs: number,\n scoringResult: ScoringResult | undefined,\n resultExtensions: Record<string, unknown> | undefined,\n response: string | undefined,\n): XAPIResult {\n return {\n completion: true,\n duration: msToIsoDuration(timeSpentMs),\n ...(scoringResult !== undefined\n ? {\n score: {\n scaled: scoringResult.score,\n raw: scoringResult.score,\n min: 0,\n max: scoringResult.maxScore,\n },\n success: scoringResult.passed,\n }\n : {}),\n ...(response !== undefined ? { response } : {}),\n ...(resultExtensions !== undefined ? { extensions: resultExtensions } : {}),\n };\n}\n\n/**\n * Constructs xAPI 1.0.3 Statements. Every call stamps a fresh UUID v4 `id`,\n * an ISO 8601 `timestamp`, and `version: '1.0.3'`. Not pure by design —\n * statements are unique events.\n */\nexport const xAPIBuilder = {\n buildStatement(params: XAPIStatementParams): XAPIStatement {\n const statement: XAPIStatement = {\n id: uuidv4(),\n actor: params.actor,\n verb: {\n id: XAPIVerb[params.verb],\n display: XAPI_VERB_DISPLAY[params.verb],\n },\n object: buildObject(params.object),\n ...(params.result !== undefined ? { result: params.result } : {}),\n ...(params.context !== undefined ? { context: params.context } : {}),\n timestamp: new Date().toISOString(),\n version: '1.0.3',\n };\n // Design xAPIBuilder step 4: validate every statement (throws in dev,\n // warns in prod). All build*Statement helpers route through here.\n validateXAPIStatement(statement);\n return statement;\n },\n\n buildAnsweredStatement(params: AnsweredStatementParams): XAPIStatement {\n return this.buildStatement({\n actor: params.actor,\n verb: 'ANSWERED',\n object: params.object,\n result: buildResult(\n params.timeSpentMs,\n params.scoringResult,\n params.resultExtensions,\n params.response,\n ),\n ...(params.context !== undefined ? { context: params.context } : {}),\n });\n },\n\n /**\n * Builds a statement for a deferred-grading submission (e.g. a written\n * response). Verb is SUBMITTED and the result deliberately omits `score`,\n * `success`, and `completion` — none of them exist until the asynchronous\n * grader runs; only `duration`, `response`, and extensions are recorded.\n */\n buildSubmittedStatement(params: SubmittedStatementParams): XAPIStatement {\n return this.buildStatement({\n actor: params.actor,\n verb: 'SUBMITTED',\n object: params.object,\n result: {\n duration: msToIsoDuration(params.timeSpentMs),\n ...(params.response !== undefined ? { response: params.response } : {}),\n ...(params.resultExtensions !== undefined ? { extensions: params.resultExtensions } : {}),\n },\n ...(params.context !== undefined ? { context: params.context } : {}),\n });\n },\n\n buildCompletedStatement(params: CompletedStatementParams): XAPIStatement {\n return this.buildStatement({\n actor: params.actor,\n verb: 'COMPLETED',\n object: params.object,\n result: buildResult(\n params.timeSpentMs,\n params.scoringResult,\n params.resultExtensions,\n undefined,\n ),\n ...(params.context !== undefined ? { context: params.context } : {}),\n });\n },\n};\n\n/**\n * Builds the xAPI `object.definition` interop fields for an activity from its\n * REGISTERED descriptor, rather than having every renderer hand-roll them.\n *\n * `ActivityTypeDescriptor.interop` declares the activity-type IRI, the\n * cmi.interaction type and how to derive `correctResponsesPattern`; before\n * this, those fields had no reader anywhere and each component rebuilt the\n * same strings inline — the same \"declared but never used\" defect the SDK\n * fixed elsewhere. Reading them here also means a consumer-registered type\n * gets correct interop for free.\n *\n * Returns an empty object for an unregistered type or one that declares no\n * interop, so it is always safe to spread.\n */\nexport function xapiDefinitionFor(data: { type: string }): Partial<XAPIObjectParams> {\n const descriptor = getActivityTypeDescriptor(data.type);\n const interop = descriptor?.interop;\n if (interop === undefined) {\n return {};\n }\n const pattern = interop.correctResponsesPattern?.(data);\n return {\n ...(interop.xapiActivityTypeIri !== undefined ? { type: interop.xapiActivityTypeIri } : {}),\n ...(interop.xapiInteractionType !== undefined\n ? { interactionType: interop.xapiInteractionType }\n : {}),\n ...(pattern !== undefined && pattern.length > 0 ? { correctResponsesPattern: pattern } : {}),\n };\n}\n"],"mappings":"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","names":[]}