@intellectif/lk-core 1.1.0 → 1.2.0

package/dist/ai-check.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ai-check/cases.ts","../src/ai-check/index.ts"],"sourcesContent":["import { aiExplanationRequest, aiHintRequest } from '../ai.js';\nimport { aiCoachingRequest } from '../ai-coaching.js';\nimport { aiWritingFeedbackRequest } from '../ai-writing.js';\nimport { gradeReadAloud } from '../scoring/speech/grade.js';\nimport type {\n  DictationData,\n  FillInTheBlanksData,\n  GapSelectData,\n  LearnerResponse,\n  MultipleChoiceData,\n  ReadAloudData,\n  WrittenResponseData,\n} from '../types/activity.js';\nimport type {\n  AiCoachingRequest,\n  AiExplanationRequest,\n  AiHintRequest,\n  AiWritingFeedbackRequest,\n} from '../types/ai.js';\nimport type { SpeechAssessment, SpeechWord } from '../types/speech.js';\n\n/**\n * The items the cases are built from. Small, ordinary language-course content\n * — and deliberately awkward in the places a model slips:\n *\n * - an answer a hint can hardly avoid naming (`Madrid`);\n * - an answer of one short word (`is`), which a hint may write as an ordinary\n *   word and must not write beside its neighbour in the passage;\n * - an accented answer (`cañón`), so a hint that spells it without the accent\n *   is still caught;\n * - a passage with more than one blank, so a hint can be about the wrong one;\n * - a short essay whose mistakes a model must quote exactly as the learner\n *   wrote them — straight apostrophes a model likes to curl, a mistake made\n *   twice — so a correction of words nobody wrote is caught.\n */\nconst capital: MultipleChoiceData = {\n  schemaVersion: '1.0',\n  type: 'multiple-choice',\n  id: 'ai-check-mc',\n  title: 'Capital cities',\n  question: 'What is the capital of Spain?',\n  mode: 'single',\n  scoringStrategy: 'all-or-nothing',\n  options: [\n    { id: 'madrid', text: 'Madrid', isCorrect: true },\n    { id: 'barcelona', text: 'Barcelona', isCorrect: false },\n    { id: 'seville', text: 'Seville', isCorrect: false },\n  ],\n};\n\nconst introduction: FillInTheBlanksData = {\n  schemaVersion: '1.0',\n  type: 'fill-in-the-blanks',\n  id: 'ai-check-fib',\n  title: 'Introducing yourself',\n  passage: 'My name {{be}} Rossi and I {{live}} in Madrid.',\n  blanks: [\n    { id: 'be', acceptedAnswers: ['is'] },\n    { id: 'live', acceptedAnswers: ['live'], hint: 'Present simple, first person.' },\n  ],\n  scoringStrategy: 'partial',\n};\n\nconst landscape: GapSelectData = {\n  schemaVersion: '1.0',\n  type: 'gap-select',\n  id: 'ai-check-gap',\n  title: 'Geography',\n  locale: 'es-ES',\n  passage: 'El río pasa por un {{g1}} muy profundo, y el agua {{g2}} fría.',\n  gaps: [\n    {\n      id: 'g1',\n      choices: [\n        { id: 'canon', text: 'cañón' },\n        { id: 'campo', text: 'campo' },\n      ],\n      correctChoiceId: 'canon',\n    },\n    {\n      id: 'g2',\n      choices: [\n        { id: 'esta', text: 'está' },\n        { id: 'es', text: 'es' },\n      ],\n      correctChoiceId: 'esta',\n    },\n  ],\n  scoringStrategy: 'partial',\n};\n\nconst listening: DictationData = {\n  schemaVersion: '1.0',\n  type: 'dictation',\n  id: 'ai-check-dictation',\n  title: 'Listen and type',\n  transcript: 'The train leaves at half past nine.',\n};\n\nconst weekend: WrittenResponseData = {\n  schemaVersion: '1.0',\n  type: 'written-response',\n  id: 'ai-check-writing',\n  title: 'Your weekend',\n  prompt: 'Write a few sentences about what you did last weekend.',\n  minWords: 15,\n  maxWords: 120,\n  languageTarget: 'en-A2',\n  rubric: {\n    criteria: [\n      { name: 'Grammar', description: 'Past tenses, articles, agreement', weight: 2 },\n      { name: 'Vocabulary', description: 'Everyday words, used correctly', weight: 1 },\n      { name: 'Task', description: 'Says what the learner did, in order', weight: 1 },\n    ],\n  },\n};\n\nconst weather: ReadAloudData = {\n  schemaVersion: '1.0',\n  type: 'read-aloud',\n  id: 'ai-check-reading',\n  title: 'Read the forecast aloud',\n  referenceText: 'The weather is warm in the north.',\n  locale: 'en-US',\n  recording: { maxSeconds: 20 },\n  scoring: {\n    dimensions: [\n      { name: 'accuracy', weight: 2 },\n      { name: 'fluency', weight: 1 },\n    ],\n  },\n};\n\n/** A word of the forecast as an engine reports it. */\nconst said = (text: string, over: Partial<SpeechWord> = {}): SpeechWord => ({\n  text,\n  error: 'none',\n  accuracy: 92,\n  ...over,\n});\n\n/**\n * An engine's assessment of the forecast. With `slips`, \"weather\" is\n * mispronounced — its \"th\" heard as /d/ or /z/ — and \"north\" is left out: the\n * marks a model must coach, and no others.\n */\nfunction forecast(slips: boolean): SpeechAssessment {\n  return {\n    assessmentVersion: '1.0',\n    status: 'assessed',\n    task: 'scripted',\n    locale: 'en-US',\n    referenceText: weather.referenceText,\n    recordingKey: 'ai-check-take',\n    assessor: { kind: 'auto', id: 'pronunciation-engine' },\n    scale: 100,\n    scores: slips ? { accuracy: 68, fluency: 81, completeness: 86 } : { accuracy: 94, fluency: 90 },\n    miscue: 'assessor',\n    phonemeAlphabet: 'ipa',\n    words: [\n      said('The'),\n      slips\n        ? said('weather', {\n            accuracy: 38,\n            error: 'mispronunciation',\n            phonemes: [\n              { symbol: 'w', accuracy: 90 },\n              { symbol: 'ɛ', accuracy: 85 },\n              {\n                symbol: 'ð',\n                accuracy: 12,\n                heardAs: [\n                  { symbol: 'd', score: 64 },\n                  { symbol: 'z', score: 21 },\n                  { symbol: 'ð', score: 12 },\n                ],\n              },\n              { symbol: 'ɚ', accuracy: 80 },\n            ],\n          })\n        : said('weather'),\n      said('is'),\n      said('warm'),\n      said('in'),\n      said('the'),\n      slips ? { text: 'north', error: 'omission' } : said('north'),\n    ],\n  };\n}\n\n/**\n * One call to make against a host's port, and what a learner was looking at\n * when the SDK would have made it.\n */\nexport interface AiCheckCase {\n  /** Stable across releases, so a host can name one in an allow-list or a report. */\n  id: string;\n  /** Which port the case is for. */\n  feature: 'explanation' | 'hint' | 'writing-feedback' | 'pronunciation-coaching';\n  /** What the learner did, in a few words, for a report a person reads. */\n  about: string;\n  /** The request, built by the SDK exactly as a component builds it. */\n  request: AiExplanationRequest | AiHintRequest | AiWritingFeedbackRequest | AiCoachingRequest;\n}\n\nconst chose = (ids: string[]): LearnerResponse => ({\n  type: 'multiple-choice',\n  selectedOptionIds: ids,\n});\nconst typed = (answers: Record<string, string>): LearnerResponse => ({\n  type: 'fill-in-the-blanks',\n  answers,\n});\nconst picked = (choices: Record<string, string>): LearnerResponse => ({\n  type: 'gap-select',\n  selections: choices,\n});\nconst wrote = (text: string): LearnerResponse => ({ type: 'dictation', text });\nconst drafted = (text: string): LearnerResponse => ({\n  type: 'written-response',\n  text,\n  wordCount: 0,\n});\n\n/** Builds a case, failing loudly rather than shipping a case with no request. */\nfunction explanationCase(\n  id: string,\n  about: string,\n  data: Parameters<typeof aiExplanationRequest>[0]['data'],\n  response: LearnerResponse,\n): AiCheckCase {\n  const request = aiExplanationRequest({ data, response });\n  if (request === null) {\n    throw new Error(`ai-check: no explanation request for \"${id}\"`);\n  }\n  return { id, feature: 'explanation', about, request };\n}\n\nfunction hintCase(\n  id: string,\n  about: string,\n  data: Parameters<typeof aiHintRequest>[0]['data'],\n  response: LearnerResponse,\n  previousHints: string[] = [],\n): AiCheckCase {\n  const request = aiHintRequest({ data, response, previousHints });\n  if (request === null) {\n    throw new Error(`ai-check: no hint request for \"${id}\"`);\n  }\n  return { id, feature: 'hint', about, request };\n}\n\nfunction writingCase(\n  id: string,\n  about: string,\n  text: string,\n  previousFeedback: string[] = [],\n  learnerLocale?: string,\n): AiCheckCase {\n  const request = aiWritingFeedbackRequest({\n    data: weekend,\n    response: drafted(text),\n    previousFeedback,\n    ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n  });\n  if (request === null) {\n    throw new Error(`ai-check: no writing feedback request for \"${id}\"`);\n  }\n  return { id, feature: 'writing-feedback', about, request };\n}\n\nfunction coachingCase(\n  id: string,\n  about: string,\n  marks: { assessment?: SpeechAssessment; fromGradeOnly?: boolean },\n  learnerLocale?: string,\n): AiCheckCase {\n  const assessment = marks.assessment ?? forecast(true);\n  const grade = gradeReadAloud(\n    weather,\n    { type: 'read-aloud', recording: { key: 'ai-check-take', mimeType: 'audio/wav' } },\n    assessment,\n    {\n      measured: { durationMs: 4000, voicedMs: 3000 },\n      plausibility: { maxWordsPerSecond: 6, minVoicedMs: 500 },\n    },\n  );\n  if ('unscorable' in grade) {\n    throw new Error(`ai-check: the reading for \"${id}\" did not grade: ${grade.reason}`);\n  }\n  const request = aiCoachingRequest({\n    data: weather,\n    ...(marks.fromGradeOnly === true ? {} : { assessment }),\n    grade,\n    ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n  });\n  if (request === null) {\n    throw new Error(`ai-check: no coaching request for \"${id}\"`);\n  }\n  return { id, feature: 'pronunciation-coaching', about, request };\n}\n\n/**\n * The cases {@link runAiCheck} runs: every type the SDK explains, answered\n * right, wrong and — where a type can be — partly right; every type it hints\n * for, before an answer and after a wrong one; and drafts of an essay, with\n * mistakes, without, and revised.\n *\n * They are ordinary calls. What makes them a test is that the SDK knows the\n * answer to each, so it can check what your model writes about it.\n *\n * A fresh array each call, so a caller may filter, slice or add to it without\n * changing what the next caller gets.\n */\nexport function aiCheckCases(): AiCheckCase[] {\n  return [\n    explanationCase('mc-correct', 'Chose the right city', capital, chose(['madrid'])),\n    explanationCase('mc-wrong', 'Chose Barcelona', capital, chose(['barcelona'])),\n    explanationCase('mc-blank', 'Chose nothing and submitted', capital, chose([])),\n    explanationCase(\n      'fib-correct',\n      'Filled both blanks correctly',\n      introduction,\n      typed({ be: 'is', live: 'live' }),\n    ),\n    explanationCase(\n      'fib-partly',\n      'One blank right, one wrong',\n      introduction,\n      typed({ be: 'is', live: 'lives' }),\n    ),\n    explanationCase(\n      'fib-wrong',\n      'Both blanks wrong',\n      introduction,\n      typed({ be: 'are', live: 'living' }),\n    ),\n    explanationCase(\n      'gap-partly',\n      'One gap right, one wrong, in Spanish',\n      landscape,\n      picked({ g1: 'canon', g2: 'es' }),\n    ),\n    explanationCase(\n      'gap-wrong',\n      'Both gaps wrong, in Spanish',\n      landscape,\n      picked({ g1: 'campo', g2: 'es' }),\n    ),\n    explanationCase(\n      'dictation-near',\n      'Typed the sentence with two words wrong',\n      listening,\n      wrote('The train leaves at half past five'),\n    ),\n    explanationCase(\n      'dictation-correct',\n      'Typed the sentence correctly',\n      listening,\n      wrote('The train leaves at half past nine.'),\n    ),\n    hintCase('mc-hint-1', 'Has not answered yet', capital, chose([])),\n    hintCase('mc-hint-2', 'Asked again after choosing Seville', capital, chose(['seville']), [\n      'Think about where the government sits.',\n    ]),\n    hintCase('fib-hint-1', 'Both blanks empty', introduction, typed({})),\n    hintCase(\n      'fib-hint-2',\n      'Asked again with one blank wrong',\n      introduction,\n      typed({ be: 'are', live: '' }),\n      ['Look again at the first blank.'],\n    ),\n    hintCase('gap-hint-1', 'Neither gap chosen, in Spanish', landscape, picked({})),\n    hintCase(\n      'gap-hint-2',\n      'Asked again with the first gap wrong',\n      landscape,\n      picked({ g1: 'campo' }),\n      ['Piensa en la forma del terreno.'],\n    ),\n    writingCase(\n      'writing-mistakes',\n      'A first draft with tense, article and agreement mistakes',\n      \"Last weekend I go to the market and buyed a apple. My friends was there too, so we don't go home early. Then I go to the cinema.\",\n    ),\n    writingCase(\n      'writing-clean',\n      'A first draft with no mistakes to correct',\n      'Last weekend I went to the market and bought an apple. My friends were there too, so we stayed until the evening. Then we went to the cinema.',\n    ),\n    writingCase(\n      'writing-revised',\n      'A second draft that fixed some mistakes',\n      \"Last weekend I went to the market and bought a apple. My friends was there too, so we didn't go home early.\",\n      ['Check your past tenses: \"go\" and \"buyed\" should be past forms.'],\n    ),\n    writingCase(\n      'writing-feedback-in-spanish',\n      'A first draft, with feedback asked for in Spanish',\n      'Last weekend I visit my grandmother. She cook a big lunch and we eat together in the garden.',\n      [],\n      'es',\n    ),\n    coachingCase('coaching-slips', 'A reading with a mispronounced \"th\" and a word left out', {\n      assessment: forecast(true),\n    }),\n    coachingCase('coaching-clean', 'A reading the engine marked correct throughout', {\n      assessment: forecast(false),\n    }),\n    coachingCase(\n      'coaching-from-grade',\n      'The same slips, from a stored grade: marks without sounds',\n      { fromGradeOnly: true },\n    ),\n    coachingCase(\n      'coaching-in-spanish',\n      'The same slips, with coaching asked for in Spanish',\n      { assessment: forecast(true) },\n      'es',\n    ),\n  ];\n}\n","/**\n * A test kit for the prompts behind your AI ports.\n *\n * The SDK cannot test your model, and will not try. What it can do is make the\n * calls a learner's questions would make — on items whose answers it knows —\n * and run the same checks it runs before a learner sees anything. What comes\n * back is a count of what would have been shown and what would have been\n * refused, and why.\n *\n * Run it where you change a prompt or a model, in your own CI, with your own\n * key. It is a separate entry point (`@intellectif/lk-core/ai-check`) because\n * it is for your test run, not for a learner's browser: nothing here is\n * imported by anything a page renders.\n *\n * ```ts\n * import { aiCheckCases, formatAiCheckReport, runAiCheck } from '@intellectif/lk-core/ai-check';\n *\n * const report = await runAiCheck({\n *   explain: (request) => callMyModel(EXPLAIN_PROMPT, request),\n *   hint: (request) => callMyModel(HINT_PROMPT, request),\n *   writingFeedback: (request) => callMyModel(FEEDBACK_PROMPT, request),\n *   pronunciationCoaching: (request) => callMyModel(COACHING_PROMPT, request),\n * });\n * console.log(formatAiCheckReport(report));\n * if (report.refused > 0 || report.errors > 0) {\n *   process.exitCode = 1;\n * }\n * ```\n *\n * A refusal is a real failure, not a warning: it is an answer a learner would\n * have asked for and not received. `reveals-answer` on a hint case is the one\n * to take most seriously — that prompt gives answers away. Next come\n * `misquotes-answer` on a writing case — that prompt corrects words the learner\n * never wrote — and `contradicts-marks` on a coaching case: that prompt coaches\n * words the engine heard as right, or sounds it never reported.\n */\nimport { checkAiExplanation, checkAiHint } from '../ai.js';\nimport { checkAiCoaching } from '../ai-coaching.js';\nimport { checkAiWritingFeedback } from '../ai-writing.js';\nimport type {\n  AiCoaching,\n  AiCoachingRequest,\n  AiExplanationRequest,\n  AiHintRequest,\n  AiRefusal,\n  AiTextResult,\n  AiWritingFeedback,\n  AiWritingFeedbackRequest,\n} from '../types/ai.js';\nimport { type AiCheckCase, aiCheckCases } from './cases.js';\n\nexport { type AiCheckCase, aiCheckCases } from './cases.js';\n\n/**\n * Your ports, as this kit calls them. The same functions\n * `<LkAiProvider ai={…}>` takes, minus the `AbortSignal` a browser passes —\n * nothing here abandons a call.\n *\n * Leave one out and its cases are skipped rather than failed.\n */\nexport interface AiCheckPorts {\n  explain?(request: AiExplanationRequest): Promise<unknown> | unknown;\n  hint?(request: AiHintRequest): Promise<unknown> | unknown;\n  writingFeedback?(request: AiWritingFeedbackRequest): Promise<unknown> | unknown;\n  pronunciationCoaching?(request: AiCoachingRequest): Promise<unknown> | unknown;\n}\n\n/** What happened on one case. */\nexport interface AiCheckResult {\n  case: AiCheckCase;\n  /** Whether a learner would have been shown what came back. */\n  ok: boolean;\n  /** Why it would not have been shown. */\n  refusal?: AiRefusal;\n  /** The port threw or rejected. Its message, as a string. */\n  error?: string;\n  /**\n   * What came back, once the SDK had read it — so a refusal can be read beside\n   * the text that caused it. Absent when the port failed or answered with\n   * nothing the SDK could read.\n   */\n  result?: AiTextResult;\n  /** For a writing case a learner would have been shown: the feedback, as the SDK accepted it. */\n  feedback?: AiWritingFeedback;\n  /** For a coaching case a learner would have been shown: the coaching, as the SDK accepted it. */\n  coaching?: AiCoaching;\n  /** How long the call took, in milliseconds. */\n  ms: number;\n}\n\n/** What a run came to. */\nexport interface AiCheckReport {\n  /** Cases run: the ones a port was supplied for. */\n  total: number;\n  /** Cases whose answer a learner would have been shown. */\n  shown: number;\n  /** Cases whose answer the SDK refused. */\n  refused: number;\n  /** Cases where the port itself failed. */\n  errors: number;\n  /** Cases skipped because no port was supplied for that feature. */\n  skipped: number;\n  /** How many refusals of each reason. */\n  byRefusal: Record<AiRefusal, number>;\n  results: AiCheckResult[];\n}\n\nexport interface AiCheckOptions {\n  /**\n   * The cases to run. Defaults to {@link aiCheckCases}. Pass a filtered list to\n   * run one type, or your own cases — built with `aiExplanationRequest` and\n   * `aiHintRequest` on your own items, which is how you test a prompt against\n   * the content your learners actually see.\n   */\n  cases?: readonly AiCheckCase[];\n  /**\n   * How many cases to have in flight at once. Default 1: a run in CI hits a\n   * rate limit far more often than it runs out of patience.\n   */\n  concurrency?: number;\n}\n\nconst REFUSALS: AiRefusal[] = [\n  'malformed',\n  'empty',\n  'too-long',\n  'contradicts-grade',\n  'reveals-answer',\n  'misquotes-answer',\n  'contradicts-marks',\n];\n\n/** The port a case is for. */\nfunction portFor(\n  ports: AiCheckPorts,\n  one: AiCheckCase,\n): ((request: never) => Promise<unknown> | unknown) | undefined {\n  switch (one.request.feature) {\n    case 'explanation':\n      return ports.explain as never;\n    case 'hint':\n      return ports.hint as never;\n    case 'pronunciation-coaching':\n      return ports.pronunciationCoaching as never;\n    default:\n      return ports.writingFeedback as never;\n  }\n}\n\n/** Milliseconds, from whichever clock this runtime has. */\nconst now = (): number => Date.now();\n\n/** Runs one case: calls the port, times it, and checks what came back. */\nasync function runCase(ports: AiCheckPorts, one: AiCheckCase): Promise<AiCheckResult> {\n  const started = now();\n  const port = portFor(ports, one);\n  if (port === undefined) {\n    throw new Error(`ai-check: no port for \"${one.id}\"`);\n  }\n  let raw: unknown;\n  try {\n    raw = await port(one.request as never);\n  } catch (error) {\n    return {\n      case: one,\n      ok: false,\n      error: error instanceof Error ? error.message : String(error),\n      ms: now() - started,\n    };\n  }\n  const ms = now() - started;\n  if (one.request.feature === 'pronunciation-coaching') {\n    const checked = checkAiCoaching(raw, one.request);\n    if (checked.ok) {\n      const { text, provenance, usage } = checked.coaching;\n      return {\n        case: one,\n        ok: true,\n        result: {\n          text,\n          ...(provenance !== undefined ? { provenance } : {}),\n          ...(usage !== undefined ? { usage } : {}),\n        },\n        coaching: checked.coaching,\n        ms,\n      };\n    }\n    return refused(one, raw, checked.refusal, ms);\n  }\n  if (one.request.feature === 'writing-feedback') {\n    const checked = checkAiWritingFeedback(raw, one.request);\n    if (checked.ok) {\n      const { text, provenance, usage } = checked.feedback;\n      return {\n        case: one,\n        ok: true,\n        result: {\n          text,\n          ...(provenance !== undefined ? { provenance } : {}),\n          ...(usage !== undefined ? { usage } : {}),\n        },\n        feedback: checked.feedback,\n        ms,\n      };\n    }\n    return refused(one, raw, checked.refusal, ms);\n  }\n  const checked =\n    one.request.feature === 'explanation'\n      ? checkAiExplanation(raw, one.request)\n      : checkAiHint(raw, one.request);\n  if (checked.ok) {\n    return { case: one, ok: true, result: checked.result, ms };\n  }\n  return refused(one, raw, checked.refusal, ms);\n}\n\n/** A case whose answer was refused, with the text that came back when there was one to read. */\nfunction refused(one: AiCheckCase, raw: unknown, refusal: AiRefusal, ms: number): AiCheckResult {\n  const text =\n    typeof (raw as { text?: unknown })?.text === 'string' ? (raw as AiTextResult) : undefined;\n  return {\n    case: one,\n    ok: false,\n    refusal,\n    ...(text !== undefined ? { result: text } : {}),\n    ms,\n  };\n}\n\n/**\n * Calls your ports on every case and reports what a learner would have seen.\n *\n * It never throws for a failing case: a port that rejects is an `error` in the\n * report, so one bad call cannot hide the rest.\n */\nexport async function runAiCheck(\n  ports: AiCheckPorts,\n  options: AiCheckOptions = {},\n): Promise<AiCheckReport> {\n  const all = options.cases ?? aiCheckCases();\n  const asked = Math.trunc(options.concurrency ?? 1);\n  const lanes = Number.isFinite(asked) && asked >= 1 ? Math.min(asked, 16) : 1;\n  const runnable = all.filter((one) => portFor(ports, one) !== undefined);\n  const results: AiCheckResult[] = new Array(runnable.length);\n  let next = 0;\n  const lane = async (): Promise<void> => {\n    while (next < runnable.length) {\n      const mine = next;\n      next += 1;\n      const one = runnable[mine];\n      if (one === undefined) {\n        return;\n      }\n      results[mine] = await runCase(ports, one);\n    }\n  };\n  await Promise.all(Array.from({ length: Math.min(lanes, runnable.length) }, lane));\n\n  const byRefusal = Object.fromEntries(REFUSALS.map((reason) => [reason, 0])) as Record<\n    AiRefusal,\n    number\n  >;\n  let shown = 0;\n  let refused = 0;\n  let errors = 0;\n  for (const result of results) {\n    if (result.ok) {\n      shown += 1;\n    } else if (result.refusal !== undefined) {\n      refused += 1;\n      byRefusal[result.refusal] += 1;\n    } else {\n      errors += 1;\n    }\n  }\n  return {\n    total: results.length,\n    shown,\n    refused,\n    errors,\n    skipped: all.length - runnable.length,\n    byRefusal,\n    results,\n  };\n}\n\n/**\n * The report as a few lines for a CI log: the counts, then every case that\n * failed, with what came back.\n *\n * The refused text is printed — this is your own test run, not a learner's\n * screen, and a hint that gives the answer away is only fixable if you can\n * read it.\n */\nexport function formatAiCheckReport(report: AiCheckReport): string {\n  const lines: string[] = [];\n  const slowest = report.results.reduce((worst, one) => Math.max(worst, one.ms), 0);\n  lines.push(\n    `ai-check: ${report.shown}/${report.total} shown, ${report.refused} refused, ${report.errors} failed` +\n      `${report.skipped > 0 ? `, ${report.skipped} skipped (no port)` : ''} — slowest ${slowest} ms`,\n  );\n  for (const reason of REFUSALS) {\n    const count = report.byRefusal[reason];\n    if (count > 0) {\n      lines.push(`  ${reason}: ${count}`);\n    }\n  }\n  for (const result of report.results) {\n    if (result.ok) {\n      continue;\n    }\n    const why = result.refusal ?? `port failed (${result.error ?? 'no message'})`;\n    lines.push(`  ✗ ${result.case.id} [${result.case.feature}] ${result.case.about}: ${why}`);\n    if (result.result !== undefined) {\n      lines.push(`      ${result.result.text.replace(/\\s+/g, ' ').slice(0, 200)}`);\n    }\n  }\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["checked","refused"]}
+{"version":3,"sources":["../src/ai-check/cases.ts","../src/ai-check/index.ts"],"sourcesContent":["import { aiExplanationRequest, aiHintRequest } from '../ai.js';\nimport { aiCoachingRequest } from '../ai-coaching.js';\nimport { aiCritiqueRequest } from '../ai-critique.js';\nimport { aiDraftsRequest } from '../ai-drafts.js';\nimport { aiWritingFeedbackRequest } from '../ai-writing.js';\nimport { gradeReadAloud } from '../scoring/speech/grade.js';\nimport type {\n  ActivityType,\n  DictationData,\n  FillInTheBlanksData,\n  GapSelectData,\n  LearnerResponse,\n  MultipleChoiceData,\n  ReadAloudData,\n  WrittenResponseData,\n} from '../types/activity.js';\nimport type {\n  AiCoachingRequest,\n  AiCritiqueRequest,\n  AiDraftSource,\n  AiDraftsRequest,\n  AiDraftType,\n  AiExplanationRequest,\n  AiHintRequest,\n  AiWritingFeedbackRequest,\n} from '../types/ai.js';\nimport type { SpeechAssessment, SpeechWord } from '../types/speech.js';\n\n/**\n * The items the cases are built from. Small, ordinary language-course content\n * — and deliberately awkward in the places a model slips:\n *\n * - an answer a hint can hardly avoid naming (`Madrid`);\n * - an answer of one short word (`is`), which a hint may write as an ordinary\n *   word and must not write beside its neighbour in the passage;\n * - an accented answer (`cañón`), so a hint that spells it without the accent\n *   is still caught;\n * - a passage with more than one blank, so a hint can be about the wrong one;\n * - a short essay whose mistakes a model must quote exactly as the learner\n *   wrote them — straight apostrophes a model likes to curl, a mistake made\n *   twice — so a correction of words nobody wrote is caught.\n */\nconst capital: MultipleChoiceData = {\n  schemaVersion: '1.0',\n  type: 'multiple-choice',\n  id: 'ai-check-mc',\n  title: 'Capital cities',\n  question: 'What is the capital of Spain?',\n  mode: 'single',\n  scoringStrategy: 'all-or-nothing',\n  options: [\n    { id: 'madrid', text: 'Madrid', isCorrect: true },\n    { id: 'barcelona', text: 'Barcelona', isCorrect: false },\n    { id: 'seville', text: 'Seville', isCorrect: false },\n  ],\n};\n\nconst introduction: FillInTheBlanksData = {\n  schemaVersion: '1.0',\n  type: 'fill-in-the-blanks',\n  id: 'ai-check-fib',\n  title: 'Introducing yourself',\n  passage: 'My name {{be}} Rossi and I {{live}} in Madrid.',\n  blanks: [\n    { id: 'be', acceptedAnswers: ['is'] },\n    { id: 'live', acceptedAnswers: ['live'], hint: 'Present simple, first person.' },\n  ],\n  scoringStrategy: 'partial',\n};\n\nconst landscape: GapSelectData = {\n  schemaVersion: '1.0',\n  type: 'gap-select',\n  id: 'ai-check-gap',\n  title: 'Geography',\n  locale: 'es-ES',\n  passage: 'El río pasa por un {{g1}} muy profundo, y el agua {{g2}} fría.',\n  gaps: [\n    {\n      id: 'g1',\n      choices: [\n        { id: 'canon', text: 'cañón' },\n        { id: 'campo', text: 'campo' },\n      ],\n      correctChoiceId: 'canon',\n    },\n    {\n      id: 'g2',\n      choices: [\n        { id: 'esta', text: 'está' },\n        { id: 'es', text: 'es' },\n      ],\n      correctChoiceId: 'esta',\n    },\n  ],\n  scoringStrategy: 'partial',\n};\n\nconst listening: DictationData = {\n  schemaVersion: '1.0',\n  type: 'dictation',\n  id: 'ai-check-dictation',\n  title: 'Listen and type',\n  transcript: 'The train leaves at half past nine.',\n};\n\nconst weekend: WrittenResponseData = {\n  schemaVersion: '1.0',\n  type: 'written-response',\n  id: 'ai-check-writing',\n  title: 'Your weekend',\n  prompt: 'Write a few sentences about what you did last weekend.',\n  minWords: 15,\n  maxWords: 120,\n  languageTarget: 'en-A2',\n  rubric: {\n    criteria: [\n      { name: 'Grammar', description: 'Past tenses, articles, agreement', weight: 2 },\n      { name: 'Vocabulary', description: 'Everyday words, used correctly', weight: 1 },\n      { name: 'Task', description: 'Says what the learner did, in order', weight: 1 },\n    ],\n  },\n};\n\nconst weather: ReadAloudData = {\n  schemaVersion: '1.0',\n  type: 'read-aloud',\n  id: 'ai-check-reading',\n  title: 'Read the forecast aloud',\n  referenceText: 'The weather is warm in the north.',\n  locale: 'en-US',\n  recording: { maxSeconds: 20 },\n  scoring: {\n    dimensions: [\n      { name: 'accuracy', weight: 2 },\n      { name: 'fluency', weight: 1 },\n    ],\n  },\n};\n\n/** A word of the forecast as an engine reports it. */\nconst said = (text: string, over: Partial<SpeechWord> = {}): SpeechWord => ({\n  text,\n  error: 'none',\n  accuracy: 92,\n  ...over,\n});\n\n/**\n * An engine's assessment of the forecast. With `slips`, \"weather\" is\n * mispronounced — its \"th\" heard as /d/ or /z/ — and \"north\" is left out: the\n * marks a model must coach, and no others.\n */\nfunction forecast(slips: boolean): SpeechAssessment {\n  return {\n    assessmentVersion: '1.0',\n    status: 'assessed',\n    task: 'scripted',\n    locale: 'en-US',\n    referenceText: weather.referenceText,\n    recordingKey: 'ai-check-take',\n    assessor: { kind: 'auto', id: 'pronunciation-engine' },\n    scale: 100,\n    scores: slips ? { accuracy: 68, fluency: 81, completeness: 86 } : { accuracy: 94, fluency: 90 },\n    miscue: 'assessor',\n    phonemeAlphabet: 'ipa',\n    words: [\n      said('The'),\n      slips\n        ? said('weather', {\n            accuracy: 38,\n            error: 'mispronunciation',\n            phonemes: [\n              { symbol: 'w', accuracy: 90 },\n              { symbol: 'ɛ', accuracy: 85 },\n              {\n                symbol: 'ð',\n                accuracy: 12,\n                heardAs: [\n                  { symbol: 'd', score: 64 },\n                  { symbol: 'z', score: 21 },\n                  { symbol: 'ð', score: 12 },\n                ],\n              },\n              { symbol: 'ɚ', accuracy: 80 },\n            ],\n          })\n        : said('weather'),\n      said('is'),\n      said('warm'),\n      said('in'),\n      said('the'),\n      slips ? { text: 'north', error: 'omission' } : said('north'),\n    ],\n  };\n}\n\n/**\n * One call to make against a host's port, and what a learner was looking at\n * when the SDK would have made it.\n */\nexport interface AiCheckCase {\n  /** Stable across releases, so a host can name one in an allow-list or a report. */\n  id: string;\n  /** Which port the case is for. */\n  feature:\n    | 'explanation'\n    | 'hint'\n    | 'writing-feedback'\n    | 'pronunciation-coaching'\n    | 'item-critique'\n    | 'draft-generation';\n  /** What the learner did, in a few words, for a report a person reads. */\n  about: string;\n  /** The request, built by the SDK exactly as a component builds it. */\n  request:\n    | AiExplanationRequest\n    | AiHintRequest\n    | AiWritingFeedbackRequest\n    | AiCoachingRequest\n    | AiCritiqueRequest\n    | AiDraftsRequest;\n}\n\nconst chose = (ids: string[]): LearnerResponse => ({\n  type: 'multiple-choice',\n  selectedOptionIds: ids,\n});\nconst typed = (answers: Record<string, string>): LearnerResponse => ({\n  type: 'fill-in-the-blanks',\n  answers,\n});\nconst picked = (choices: Record<string, string>): LearnerResponse => ({\n  type: 'gap-select',\n  selections: choices,\n});\nconst wrote = (text: string): LearnerResponse => ({ type: 'dictation', text });\nconst drafted = (text: string): LearnerResponse => ({\n  type: 'written-response',\n  text,\n  wordCount: 0,\n});\n\n/**\n * Items an author asks a model to review. Each is valid, and each but the last\n * has a flaw a rule cannot see: a distractor that is botanically a right\n * answer, and a task far above the level it is set for.\n */\nconst fruit: MultipleChoiceData = {\n  schemaVersion: '1.0',\n  type: 'multiple-choice',\n  id: 'ai-check-fruit',\n  title: 'Food words',\n  question: 'Which of these is a fruit?',\n  mode: 'single',\n  scoringStrategy: 'all-or-nothing',\n  options: [\n    { id: 'f1', text: 'Apple', isCorrect: true },\n    { id: 'f2', text: 'Carrot', isCorrect: false },\n    { id: 'f3', text: 'Tomato', isCorrect: false },\n  ],\n};\n\nconst tooHard: WrittenResponseData = {\n  schemaVersion: '1.0',\n  type: 'written-response',\n  id: 'ai-check-too-hard',\n  title: 'Cities',\n  prompt: 'Discuss the socioeconomic ramifications of rapid urbanisation in developing economies.',\n  minWords: 40,\n  maxWords: 80,\n};\n\nconst cleanCloze: FillInTheBlanksData = {\n  schemaVersion: '1.0',\n  type: 'fill-in-the-blanks',\n  id: 'ai-check-clean-cloze',\n  title: 'Daily routine',\n  passage: 'Every morning I {{1}} up at seven and {{2}} a shower.',\n  blanks: [\n    { id: '1', acceptedAnswers: ['get', 'wake'] },\n    { id: '2', acceptedAnswers: ['take', 'have'] },\n  ],\n  scoringStrategy: 'partial',\n};\n\nfunction critiqueCase(\n  id: string,\n  about: string,\n  type: ActivityType,\n  draft: unknown,\n  extra: { level?: string; authorLocale?: string } = {},\n): AiCheckCase {\n  const request = aiCritiqueRequest({ type, draft, ...extra });\n  if (request === null) {\n    throw new Error(`ai-check: no critique request for \"${id}\"`);\n  }\n  return { id, feature: 'item-critique', about, request };\n}\n\n/** A short reading to draft from: plain, and with facts a question can be asked about. */\nconst MARKET =\n  'Maria lives in Seville, in the south of Spain. Every Saturday she walks to the market with her ' +\n  'grandmother. They buy oranges, fresh bread and a little cheese. On the way home they stop at a ' +\n  'café, where Maria drinks hot chocolate and her grandmother reads the newspaper.';\n\n/** The same reading as a video's captions, with times in seconds. */\nconst MARKET_CAPTIONS = [\n  { start: 0, end: 4.2, text: 'Maria lives in Seville, in the south of Spain.' },\n  { start: 4.2, end: 8.9, text: 'Every Saturday she walks to the market with her grandmother.' },\n  { start: 8.9, end: 12.6, text: 'They buy oranges, fresh bread and a little cheese.' },\n  { start: 12.6, end: 18.1, text: 'On the way home they stop at a café.' },\n];\n\nfunction draftsCase(\n  id: string,\n  about: string,\n  types: AiDraftType[],\n  source: AiDraftSource,\n  extra: Omit<Parameters<typeof aiDraftsRequest>[0], 'types' | 'source'> = {},\n): AiCheckCase {\n  const request = aiDraftsRequest({ types, source, ...extra });\n  if (request === null) {\n    throw new Error(`ai-check: no drafts request for \"${id}\"`);\n  }\n  return { id, feature: 'draft-generation', about, request };\n}\n\n/**\n * What a host sets on every read-aloud it drafts: the SDK has no default for a\n * recording's length or the dimensions a reading is graded on.\n */\nconst READ_ALOUD_SETTINGS = {\n  locale: 'en-US',\n  recording: { maxSeconds: 20 },\n  scoring: { dimensions: [{ name: 'accuracy', weight: 1 }] },\n};\n\n/** Builds a case, failing loudly rather than shipping a case with no request. */\nfunction explanationCase(\n  id: string,\n  about: string,\n  data: Parameters<typeof aiExplanationRequest>[0]['data'],\n  response: LearnerResponse,\n): AiCheckCase {\n  const request = aiExplanationRequest({ data, response });\n  if (request === null) {\n    throw new Error(`ai-check: no explanation request for \"${id}\"`);\n  }\n  return { id, feature: 'explanation', about, request };\n}\n\nfunction hintCase(\n  id: string,\n  about: string,\n  data: Parameters<typeof aiHintRequest>[0]['data'],\n  response: LearnerResponse,\n  previousHints: string[] = [],\n): AiCheckCase {\n  const request = aiHintRequest({ data, response, previousHints });\n  if (request === null) {\n    throw new Error(`ai-check: no hint request for \"${id}\"`);\n  }\n  return { id, feature: 'hint', about, request };\n}\n\nfunction writingCase(\n  id: string,\n  about: string,\n  text: string,\n  previousFeedback: string[] = [],\n  learnerLocale?: string,\n): AiCheckCase {\n  const request = aiWritingFeedbackRequest({\n    data: weekend,\n    response: drafted(text),\n    previousFeedback,\n    ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n  });\n  if (request === null) {\n    throw new Error(`ai-check: no writing feedback request for \"${id}\"`);\n  }\n  return { id, feature: 'writing-feedback', about, request };\n}\n\nfunction coachingCase(\n  id: string,\n  about: string,\n  marks: { assessment?: SpeechAssessment; fromGradeOnly?: boolean },\n  learnerLocale?: string,\n): AiCheckCase {\n  const assessment = marks.assessment ?? forecast(true);\n  const grade = gradeReadAloud(\n    weather,\n    { type: 'read-aloud', recording: { key: 'ai-check-take', mimeType: 'audio/wav' } },\n    assessment,\n    {\n      measured: { durationMs: 4000, voicedMs: 3000 },\n      plausibility: { maxWordsPerSecond: 6, minVoicedMs: 500 },\n    },\n  );\n  if ('unscorable' in grade) {\n    throw new Error(`ai-check: the reading for \"${id}\" did not grade: ${grade.reason}`);\n  }\n  const request = aiCoachingRequest({\n    data: weather,\n    ...(marks.fromGradeOnly === true ? {} : { assessment }),\n    grade,\n    ...(learnerLocale !== undefined ? { learnerLocale } : {}),\n  });\n  if (request === null) {\n    throw new Error(`ai-check: no coaching request for \"${id}\"`);\n  }\n  return { id, feature: 'pronunciation-coaching', about, request };\n}\n\n/**\n * The cases {@link runAiCheck} runs: every type the SDK explains, answered\n * right, wrong and — where a type can be — partly right; every type it hints\n * for, before an answer and after a wrong one; and drafts of an essay, with\n * mistakes, without, and revised.\n *\n * They are ordinary calls. What makes them a test is that the SDK knows the\n * answer to each, so it can check what your model writes about it.\n *\n * A fresh array each call, so a caller may filter, slice or add to it without\n * changing what the next caller gets.\n */\nexport function aiCheckCases(): AiCheckCase[] {\n  return [\n    explanationCase('mc-correct', 'Chose the right city', capital, chose(['madrid'])),\n    explanationCase('mc-wrong', 'Chose Barcelona', capital, chose(['barcelona'])),\n    explanationCase('mc-blank', 'Chose nothing and submitted', capital, chose([])),\n    explanationCase(\n      'fib-correct',\n      'Filled both blanks correctly',\n      introduction,\n      typed({ be: 'is', live: 'live' }),\n    ),\n    explanationCase(\n      'fib-partly',\n      'One blank right, one wrong',\n      introduction,\n      typed({ be: 'is', live: 'lives' }),\n    ),\n    explanationCase(\n      'fib-wrong',\n      'Both blanks wrong',\n      introduction,\n      typed({ be: 'are', live: 'living' }),\n    ),\n    explanationCase(\n      'gap-partly',\n      'One gap right, one wrong, in Spanish',\n      landscape,\n      picked({ g1: 'canon', g2: 'es' }),\n    ),\n    explanationCase(\n      'gap-wrong',\n      'Both gaps wrong, in Spanish',\n      landscape,\n      picked({ g1: 'campo', g2: 'es' }),\n    ),\n    explanationCase(\n      'dictation-near',\n      'Typed the sentence with two words wrong',\n      listening,\n      wrote('The train leaves at half past five'),\n    ),\n    explanationCase(\n      'dictation-correct',\n      'Typed the sentence correctly',\n      listening,\n      wrote('The train leaves at half past nine.'),\n    ),\n    hintCase('mc-hint-1', 'Has not answered yet', capital, chose([])),\n    hintCase('mc-hint-2', 'Asked again after choosing Seville', capital, chose(['seville']), [\n      'Think about where the government sits.',\n    ]),\n    hintCase('fib-hint-1', 'Both blanks empty', introduction, typed({})),\n    hintCase(\n      'fib-hint-2',\n      'Asked again with one blank wrong',\n      introduction,\n      typed({ be: 'are', live: '' }),\n      ['Look again at the first blank.'],\n    ),\n    hintCase('gap-hint-1', 'Neither gap chosen, in Spanish', landscape, picked({})),\n    hintCase(\n      'gap-hint-2',\n      'Asked again with the first gap wrong',\n      landscape,\n      picked({ g1: 'campo' }),\n      ['Piensa en la forma del terreno.'],\n    ),\n    writingCase(\n      'writing-mistakes',\n      'A first draft with tense, article and agreement mistakes',\n      \"Last weekend I go to the market and buyed a apple. My friends was there too, so we don't go home early. Then I go to the cinema.\",\n    ),\n    writingCase(\n      'writing-clean',\n      'A first draft with no mistakes to correct',\n      'Last weekend I went to the market and bought an apple. My friends were there too, so we stayed until the evening. Then we went to the cinema.',\n    ),\n    writingCase(\n      'writing-revised',\n      'A second draft that fixed some mistakes',\n      \"Last weekend I went to the market and bought a apple. My friends was there too, so we didn't go home early.\",\n      ['Check your past tenses: \"go\" and \"buyed\" should be past forms.'],\n    ),\n    writingCase(\n      'writing-feedback-in-spanish',\n      'A first draft, with feedback asked for in Spanish',\n      'Last weekend I visit my grandmother. She cook a big lunch and we eat together in the garden.',\n      [],\n      'es',\n    ),\n    coachingCase('coaching-slips', 'A reading with a mispronounced \"th\" and a word left out', {\n      assessment: forecast(true),\n    }),\n    coachingCase('coaching-clean', 'A reading the engine marked correct throughout', {\n      assessment: forecast(false),\n    }),\n    coachingCase(\n      'coaching-from-grade',\n      'The same slips, from a stored grade: marks without sounds',\n      { fromGradeOnly: true },\n    ),\n    coachingCase(\n      'coaching-in-spanish',\n      'The same slips, with coaching asked for in Spanish',\n      { assessment: forecast(true) },\n      'es',\n    ),\n    critiqueCase(\n      'critique-second-answer',\n      'A question whose distractor \"Tomato\" is botanically a fruit',\n      'multiple-choice',\n      fruit,\n      { level: 'A1' },\n    ),\n    critiqueCase(\n      'critique-level',\n      'A writing task far above the A1 level it is set for',\n      'written-response',\n      tooHard,\n      { level: 'A1' },\n    ),\n    critiqueCase(\n      'critique-clean',\n      'A cloze with nothing wrong in it',\n      'fill-in-the-blanks',\n      cleanCloze,\n      {\n        level: 'A2',\n      },\n    ),\n    critiqueCase(\n      'critique-in-spanish',\n      'The fruit question, reviewed in Spanish for its author',\n      'multiple-choice',\n      fruit,\n      { level: 'A1', authorLocale: 'es' },\n    ),\n    draftsCase(\n      'drafts-questions',\n      'Four multiple-choice questions on a short reading',\n      ['multiple-choice'],\n      { kind: 'passage', text: MARKET },\n      { count: 4, level: 'A2', locale: 'en' },\n    ),\n    draftsCase(\n      'drafts-cloze',\n      'A cloze on the same reading, from its transcript',\n      ['fill-in-the-blanks'],\n      { kind: 'transcript', text: MARKET },\n      { count: 1, level: 'A2', locale: 'en', instructions: 'Blank the verbs.' },\n    ),\n    draftsCase(\n      'drafts-gaps',\n      'A choose-the-word item on the same reading',\n      ['gap-select'],\n      { kind: 'passage', text: MARKET },\n      { count: 1, level: 'A2', locale: 'en' },\n    ),\n    draftsCase(\n      'drafts-writing',\n      'A writing task that follows on from the reading',\n      ['written-response'],\n      { kind: 'passage', text: MARKET },\n      { count: 1, level: 'A2', locale: 'en' },\n    ),\n    draftsCase(\n      'drafts-video',\n      'A video quiz from timed captions: multiple choice, then dictation, then read-aloud, as many as the video is worth',\n      ['multiple-choice', 'dictation', 'read-aloud'],\n      { kind: 'captions', cues: MARKET_CAPTIONS },\n      { level: 'A2', locale: 'en', settings: { 'read-aloud': READ_ALOUD_SETTINGS } },\n    ),\n    draftsCase(\n      'drafts-script',\n      'The same video from its script alone, with no times, and what the author asked for',\n      ['multiple-choice', 'dictation', 'read-aloud'],\n      { kind: 'transcript', text: MARKET },\n      {\n        level: 'A2',\n        locale: 'en',\n        instructions: 'Focus on what Maria and her grandmother buy.',\n        settings: { 'read-aloud': READ_ALOUD_SETTINGS },\n      },\n    ),\n  ];\n}\n","/**\n * A test kit for the prompts behind your AI ports.\n *\n * The SDK cannot test your model, and will not try. What it can do is make the\n * calls a learner's questions would make — on items whose answers it knows —\n * and run the same checks it runs before a learner sees anything. What comes\n * back is a count of what would have been shown and what would have been\n * refused, and why.\n *\n * Run it where you change a prompt or a model, in your own CI, with your own\n * key. It is a separate entry point (`@intellectif/lk-core/ai-check`) because\n * it is for your test run, not for a learner's browser: nothing here is\n * imported by anything a page renders.\n *\n * ```ts\n * import { aiCheckCases, formatAiCheckReport, runAiCheck } from '@intellectif/lk-core/ai-check';\n *\n * const report = await runAiCheck({\n *   explain: (request) => callMyModel(EXPLAIN_PROMPT, request),\n *   hint: (request) => callMyModel(HINT_PROMPT, request),\n *   writingFeedback: (request) => callMyModel(FEEDBACK_PROMPT, request),\n *   pronunciationCoaching: (request) => callMyModel(COACHING_PROMPT, request),\n *   critique: (request) => callMyModel(CRITIQUE_PROMPT, request),\n *   drafts: (request) => callMyModel(DRAFTS_PROMPT, request),\n * });\n * console.log(formatAiCheckReport(report));\n * if (report.refused > 0 || report.errors > 0) {\n *   process.exitCode = 1;\n * }\n * ```\n *\n * A refusal is a real failure, not a warning: it is an answer a learner would\n * have asked for and not received. `reveals-answer` on a hint case is the one\n * to take most seriously — that prompt gives answers away. Next come\n * `misquotes-answer` on a writing case — that prompt corrects words the learner\n * never wrote — and `contradicts-marks` on a coaching case: that prompt coaches\n * words the engine heard as right, or sounds it never reported.\n */\nimport { checkAiExplanation, checkAiHint } from '../ai.js';\nimport { checkAiCoaching } from '../ai-coaching.js';\nimport { checkAiCritique } from '../ai-critique.js';\nimport { checkAiDrafts } from '../ai-drafts.js';\nimport { checkAiWritingFeedback } from '../ai-writing.js';\nimport type {\n  AiCoaching,\n  AiCoachingRequest,\n  AiCritique,\n  AiCritiqueRequest,\n  AiDrafts,\n  AiDraftsRequest,\n  AiExplanationRequest,\n  AiHintRequest,\n  AiRefusal,\n  AiTextResult,\n  AiWritingFeedback,\n  AiWritingFeedbackRequest,\n} from '../types/ai.js';\nimport { type AiCheckCase, aiCheckCases } from './cases.js';\n\nexport { type AiCheckCase, aiCheckCases } from './cases.js';\n\n/**\n * Your ports, as this kit calls them. The same functions\n * `<LkAiProvider ai={…}>` takes, minus the `AbortSignal` a browser passes —\n * nothing here abandons a call.\n *\n * Leave one out and its cases are skipped rather than failed.\n */\nexport interface AiCheckPorts {\n  explain?(request: AiExplanationRequest): Promise<unknown> | unknown;\n  hint?(request: AiHintRequest): Promise<unknown> | unknown;\n  writingFeedback?(request: AiWritingFeedbackRequest): Promise<unknown> | unknown;\n  pronunciationCoaching?(request: AiCoachingRequest): Promise<unknown> | unknown;\n  /** Reviews an item for its author: the port an editor's \"Review with AI\" calls. */\n  critique?(request: AiCritiqueRequest): Promise<unknown> | unknown;\n  /** Drafts items from a source, for an author to approve. */\n  drafts?(request: AiDraftsRequest): Promise<unknown> | unknown;\n}\n\n/** What happened on one case. */\nexport interface AiCheckResult {\n  case: AiCheckCase;\n  /** Whether a learner would have been shown what came back. */\n  ok: boolean;\n  /** Why it would not have been shown. */\n  refusal?: AiRefusal;\n  /** The port threw or rejected. Its message, as a string. */\n  error?: string;\n  /**\n   * What came back, once the SDK had read it — so a refusal can be read beside\n   * the text that caused it. Absent when the port failed or answered with\n   * nothing the SDK could read.\n   */\n  result?: AiTextResult;\n  /** For a writing case a learner would have been shown: the feedback, as the SDK accepted it. */\n  feedback?: AiWritingFeedback;\n  /** For a coaching case a learner would have been shown: the coaching, as the SDK accepted it. */\n  coaching?: AiCoaching;\n  /** For a critique case an author would have been shown: the findings, as the SDK accepted them. */\n  critique?: AiCritique;\n  /**\n   * For a drafts case the SDK read: the drafts, each with what `validateDraft`\n   * and the item critic say of it. A reply read is not a good one — check how\n   * many came back `complete` and without warnings.\n   */\n  drafts?: AiDrafts;\n  /** How long the call took, in milliseconds. */\n  ms: number;\n}\n\n/** What a run came to. */\nexport interface AiCheckReport {\n  /** Cases run: the ones a port was supplied for. */\n  total: number;\n  /** Cases whose answer a learner would have been shown. */\n  shown: number;\n  /** Cases whose answer the SDK refused. */\n  refused: number;\n  /** Cases where the port itself failed. */\n  errors: number;\n  /** Cases skipped because no port was supplied for that feature. */\n  skipped: number;\n  /** How many refusals of each reason. */\n  byRefusal: Record<AiRefusal, number>;\n  results: AiCheckResult[];\n}\n\nexport interface AiCheckOptions {\n  /**\n   * The cases to run. Defaults to {@link aiCheckCases}. Pass a filtered list to\n   * run one type, or your own cases — built with `aiExplanationRequest` and\n   * `aiHintRequest` on your own items, which is how you test a prompt against\n   * the content your learners actually see.\n   */\n  cases?: readonly AiCheckCase[];\n  /**\n   * How many cases to have in flight at once. Default 1: a run in CI hits a\n   * rate limit far more often than it runs out of patience.\n   */\n  concurrency?: number;\n}\n\nconst REFUSALS: AiRefusal[] = [\n  'malformed',\n  'empty',\n  'too-long',\n  'contradicts-grade',\n  'reveals-answer',\n  'misquotes-answer',\n  'contradicts-marks',\n  'contradicts-item',\n];\n\n/** The port a case is for. */\nfunction portFor(\n  ports: AiCheckPorts,\n  one: AiCheckCase,\n): ((request: never) => Promise<unknown> | unknown) | undefined {\n  switch (one.request.feature) {\n    case 'explanation':\n      return ports.explain as never;\n    case 'hint':\n      return ports.hint as never;\n    case 'pronunciation-coaching':\n      return ports.pronunciationCoaching as never;\n    case 'item-critique':\n      return ports.critique as never;\n    case 'draft-generation':\n      return ports.drafts as never;\n    default:\n      return ports.writingFeedback as never;\n  }\n}\n\n/** Milliseconds, from whichever clock this runtime has. */\nconst now = (): number => Date.now();\n\n/** Runs one case: calls the port, times it, and checks what came back. */\nasync function runCase(ports: AiCheckPorts, one: AiCheckCase): Promise<AiCheckResult> {\n  const started = now();\n  const port = portFor(ports, one);\n  if (port === undefined) {\n    throw new Error(`ai-check: no port for \"${one.id}\"`);\n  }\n  let raw: unknown;\n  try {\n    raw = await port(one.request as never);\n  } catch (error) {\n    return {\n      case: one,\n      ok: false,\n      error: error instanceof Error ? error.message : String(error),\n      ms: now() - started,\n    };\n  }\n  const ms = now() - started;\n  if (one.request.feature === 'draft-generation') {\n    let next = 0;\n    const checked = checkAiDrafts(raw, one.request, {\n      newId: () => {\n        next += 1;\n        return `ai-check-${next}`;\n      },\n    });\n    return checked.ok\n      ? { case: one, ok: true, drafts: checked.drafts, ms }\n      : refused(one, raw, checked.refusal, ms);\n  }\n  if (one.request.feature === 'item-critique') {\n    const checked = checkAiCritique(raw, one.request);\n    return checked.ok\n      ? { case: one, ok: true, critique: checked.critique, ms }\n      : refused(one, raw, checked.refusal, ms);\n  }\n  if (one.request.feature === 'pronunciation-coaching') {\n    const checked = checkAiCoaching(raw, one.request);\n    if (checked.ok) {\n      const { text, provenance, usage } = checked.coaching;\n      return {\n        case: one,\n        ok: true,\n        result: {\n          text,\n          ...(provenance !== undefined ? { provenance } : {}),\n          ...(usage !== undefined ? { usage } : {}),\n        },\n        coaching: checked.coaching,\n        ms,\n      };\n    }\n    return refused(one, raw, checked.refusal, ms);\n  }\n  if (one.request.feature === 'writing-feedback') {\n    const checked = checkAiWritingFeedback(raw, one.request);\n    if (checked.ok) {\n      const { text, provenance, usage } = checked.feedback;\n      return {\n        case: one,\n        ok: true,\n        result: {\n          text,\n          ...(provenance !== undefined ? { provenance } : {}),\n          ...(usage !== undefined ? { usage } : {}),\n        },\n        feedback: checked.feedback,\n        ms,\n      };\n    }\n    return refused(one, raw, checked.refusal, ms);\n  }\n  const checked =\n    one.request.feature === 'explanation'\n      ? checkAiExplanation(raw, one.request)\n      : checkAiHint(raw, one.request);\n  if (checked.ok) {\n    return { case: one, ok: true, result: checked.result, ms };\n  }\n  return refused(one, raw, checked.refusal, ms);\n}\n\n/** A case whose answer was refused, with the text that came back when there was one to read. */\nfunction refused(one: AiCheckCase, raw: unknown, refusal: AiRefusal, ms: number): AiCheckResult {\n  const text =\n    typeof (raw as { text?: unknown })?.text === 'string' ? (raw as AiTextResult) : undefined;\n  return {\n    case: one,\n    ok: false,\n    refusal,\n    ...(text !== undefined ? { result: text } : {}),\n    ms,\n  };\n}\n\n/**\n * Calls your ports on every case and reports what a learner would have seen.\n *\n * It never throws for a failing case: a port that rejects is an `error` in the\n * report, so one bad call cannot hide the rest.\n */\nexport async function runAiCheck(\n  ports: AiCheckPorts,\n  options: AiCheckOptions = {},\n): Promise<AiCheckReport> {\n  const all = options.cases ?? aiCheckCases();\n  const asked = Math.trunc(options.concurrency ?? 1);\n  const lanes = Number.isFinite(asked) && asked >= 1 ? Math.min(asked, 16) : 1;\n  const runnable = all.filter((one) => portFor(ports, one) !== undefined);\n  const results: AiCheckResult[] = new Array(runnable.length);\n  let next = 0;\n  const lane = async (): Promise<void> => {\n    while (next < runnable.length) {\n      const mine = next;\n      next += 1;\n      const one = runnable[mine];\n      if (one === undefined) {\n        return;\n      }\n      results[mine] = await runCase(ports, one);\n    }\n  };\n  await Promise.all(Array.from({ length: Math.min(lanes, runnable.length) }, lane));\n\n  const byRefusal = Object.fromEntries(REFUSALS.map((reason) => [reason, 0])) as Record<\n    AiRefusal,\n    number\n  >;\n  let shown = 0;\n  let refused = 0;\n  let errors = 0;\n  for (const result of results) {\n    if (result.ok) {\n      shown += 1;\n    } else if (result.refusal !== undefined) {\n      refused += 1;\n      byRefusal[result.refusal] += 1;\n    } else {\n      errors += 1;\n    }\n  }\n  return {\n    total: results.length,\n    shown,\n    refused,\n    errors,\n    skipped: all.length - runnable.length,\n    byRefusal,\n    results,\n  };\n}\n\n/**\n * The report as a few lines for a CI log: the counts, then every case that\n * failed, with what came back.\n *\n * The refused text is printed — this is your own test run, not a learner's\n * screen, and a hint that gives the answer away is only fixable if you can\n * read it.\n */\nexport function formatAiCheckReport(report: AiCheckReport): string {\n  const lines: string[] = [];\n  const slowest = report.results.reduce((worst, one) => Math.max(worst, one.ms), 0);\n  lines.push(\n    `ai-check: ${report.shown}/${report.total} shown, ${report.refused} refused, ${report.errors} failed` +\n      `${report.skipped > 0 ? `, ${report.skipped} skipped (no port)` : ''} — slowest ${slowest} ms`,\n  );\n  for (const reason of REFUSALS) {\n    const count = report.byRefusal[reason];\n    if (count > 0) {\n      lines.push(`  ${reason}: ${count}`);\n    }\n  }\n  for (const result of report.results) {\n    if (result.ok) {\n      continue;\n    }\n    const why = result.refusal ?? `port failed (${result.error ?? 'no message'})`;\n    lines.push(`  ✗ ${result.case.id} [${result.case.feature}] ${result.case.about}: ${why}`);\n    if (result.result !== undefined) {\n      lines.push(`      ${result.result.text.replace(/\\s+/g, ' ').slice(0, 200)}`);\n    }\n  }\n  return lines.join('\\n');\n}\n"],"mappings":"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","names":["checked","refused"]}

package/dist/{chunk-TJJFKKH2.cjs → chunk-46BXIGLG.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkDSDXL3JOcjs = require('./chunk-DSDXL3JO.cjs');
+var _chunk7THXD7ANcjs = require('./chunk-7THXD7AN.cjs');
 
 // src/xapi/validators.ts
 var _v4 = require('zod/v4');
@@ -86,7 +86,7 @@ function validateXAPIStatement(statement) {
     console.warn("[learning-kit] Invalid xAPI statement (sent anyway):", errors);
     return;
   }
-  throw new (0, _chunkDSDXL3JOcjs.ActivitySchemaError)("xAPIStatement", errors);
+  throw new (0, _chunk7THXD7ANcjs.ActivitySchemaError)("xAPIStatement", errors);
 }
 
 // src/xapi/verbs.ts
@@ -249,7 +249,7 @@ var xAPIBuilder = {
   }
 };
 function xapiDefinitionFor(data) {
-  const descriptor = _chunkDSDXL3JOcjs.getActivityTypeDescriptor.call(void 0, data.type);
+  const descriptor = _chunk7THXD7ANcjs.getActivityTypeDescriptor.call(void 0, data.type);
   const interop = _optionalChain([descriptor, 'optionalAccess', _3 => _3.interop]);
   if (interop === void 0) {
     return {};
@@ -269,4 +269,4 @@ function xapiDefinitionFor(data) {
 
 
 exports.validateXAPIStatement = validateXAPIStatement; exports.XAPIVerb = XAPIVerb; exports.XAPI_VERB_DISPLAY = XAPI_VERB_DISPLAY; exports.xAPIBuilder = xAPIBuilder; exports.xapiDefinitionFor = xapiDefinitionFor;
-//# sourceMappingURL=chunk-TJJFKKH2.cjs.map
+//# sourceMappingURL=chunk-46BXIGLG.cjs.map

package/dist/{chunk-TJJFKKH2.cjs.map → chunk-46BXIGLG.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-TJJFKKH2.cjs","../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"names":[],"mappings":"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ACF,EAAA;AAEA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AAEA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AACF;AAgBgB;AACR,EAAA;AACA,EAAA;AACF,EAAA;AACF,IAAA;AACF,EAAA;AACM,EAAA;AACC,EAAA;AACD,IAAA;AACA,IAAA;AAGA,IAAA;AACN,EAAA;AACF;AHLU;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-TJJFKKH2.cjs","sourcesContent":[null,"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"]}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-46BXIGLG.cjs","../src/xapi/validators.ts","../src/xapi/verbs.ts","../src/xapi/builder.ts"],"names":[],"mappings":"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ACF,EAAA;AAEA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AAEA,EAAA;AACE,IAAA;AACE,MAAA;AACA,MAAA;AACA,MAAA;AACA,MAAA;AACE,QAAA;AACA,QAAA;AACA,QAAA;AACA,QAAA;AACF,MAAA;AACI,MAAA;AACL,IAAA;AACH,EAAA;AACF;AAgBgB;AACR,EAAA;AACA,EAAA;AACF,EAAA;AACF,IAAA;AACF,EAAA;AACM,EAAA;AACC,EAAA;AACD,IAAA;AACA,IAAA;AAGA,IAAA;AACN,EAAA;AACF;AHLU;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/chunk-46BXIGLG.cjs","sourcesContent":[null,"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"]}