@intellectif/lk-core 0.20.0 → 0.22.0

package/dist/ai-check.cjs

@@ -3,8 +3,10 @@
 
 
 
-var _chunkFVZJ4X3Ycjs = require('./chunk-FVZJ4X3Y.cjs');
-require('./chunk-COBK2RUX.cjs');
+
+
+var _chunkOPMY2MNScjs = require('./chunk-OPMY2MNS.cjs');
+require('./chunk-WQVZPIN7.cjs');
 require('./chunk-D4TOPSHV.cjs');
 
 // src/ai-check/cases.ts
@@ -68,6 +70,23 @@ var listening = {
   title: "Listen and type",
   transcript: "The train leaves at half past nine."
 };
+var weekend = {
+  schemaVersion: "1.0",
+  type: "written-response",
+  id: "ai-check-writing",
+  title: "Your weekend",
+  prompt: "Write a few sentences about what you did last weekend.",
+  minWords: 15,
+  maxWords: 120,
+  languageTarget: "en-A2",
+  rubric: {
+    criteria: [
+      { name: "Grammar", description: "Past tenses, articles, agreement", weight: 2 },
+      { name: "Vocabulary", description: "Everyday words, used correctly", weight: 1 },
+      { name: "Task", description: "Says what the learner did, in order", weight: 1 }
+    ]
+  }
+};
 var chose = (ids) => ({
   type: "multiple-choice",
   selectedOptionIds: ids
@@ -81,20 +100,37 @@ var picked = (choices) => ({
   selections: choices
 });
 var wrote = (text) => ({ type: "dictation", text });
+var drafted = (text) => ({
+  type: "written-response",
+  text,
+  wordCount: 0
+});
 function explanationCase(id, about, data, response) {
-  const request = _chunkFVZJ4X3Ycjs.aiExplanationRequest.call(void 0, { data, response });
+  const request = _chunkOPMY2MNScjs.aiExplanationRequest.call(void 0, { data, response });
   if (request === null) {
     throw new Error(`ai-check: no explanation request for "${id}"`);
   }
   return { id, feature: "explanation", about, request };
 }
 function hintCase(id, about, data, response, previousHints = []) {
-  const request = _chunkFVZJ4X3Ycjs.aiHintRequest.call(void 0, { data, response, previousHints });
+  const request = _chunkOPMY2MNScjs.aiHintRequest.call(void 0, { data, response, previousHints });
   if (request === null) {
     throw new Error(`ai-check: no hint request for "${id}"`);
   }
   return { id, feature: "hint", about, request };
 }
+function writingCase(id, about, text, previousFeedback = [], learnerLocale) {
+  const request = _chunkOPMY2MNScjs.aiWritingFeedbackRequest.call(void 0, {
+    data: weekend,
+    response: drafted(text),
+    previousFeedback,
+    ...learnerLocale !== void 0 ? { learnerLocale } : {}
+  });
+  if (request === null) {
+    throw new Error(`ai-check: no writing feedback request for "${id}"`);
+  }
+  return { id, feature: "writing-feedback", about, request };
+}
 function aiCheckCases() {
   return [
     explanationCase("mc-correct", "Chose the right city", capital, chose(["madrid"])),
@@ -161,6 +197,29 @@ function aiCheckCases() {
       landscape,
       picked({ g1: "campo" }),
       ["Piensa en la forma del terreno."]
+    ),
+    writingCase(
+      "writing-mistakes",
+      "A first draft with tense, article and agreement mistakes",
+      "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."
+    ),
+    writingCase(
+      "writing-clean",
+      "A first draft with no mistakes to correct",
+      "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."
+    ),
+    writingCase(
+      "writing-revised",
+      "A second draft that fixed some mistakes",
+      "Last weekend I went to the market and bought a apple. My friends was there too, so we didn't go home early.",
+      ['Check your past tenses: "go" and "buyed" should be past forms.']
+    ),
+    writingCase(
+      "writing-feedback-in-spanish",
+      "A first draft, with feedback asked for in Spanish",
+      "Last weekend I visit my grandmother. She cook a big lunch and we eat together in the garden.",
+      [],
+      "es"
     )
   ];
 }
@@ -171,13 +230,23 @@ var REFUSALS = [
   "empty",
   "too-long",
   "contradicts-grade",
-  "reveals-answer"
+  "reveals-answer",
+  "misquotes-answer"
 ];
+function portFor(ports, one) {
+  switch (one.request.feature) {
+    case "explanation":
+      return ports.explain;
+    case "hint":
+      return ports.hint;
+    default:
+      return ports.writingFeedback;
+  }
+}
 var now = () => Date.now();
 async function runCase(ports, one) {
   const started = now();
-  const explaining = one.request.feature === "explanation";
-  const port = explaining ? ports.explain : ports.hint;
+  const port = portFor(ports, one);
   if (port === void 0) {
     throw new Error(`ai-check: no port for "${one.id}"`);
   }
@@ -193,15 +262,36 @@ async function runCase(ports, one) {
     };
   }
   const ms = now() - started;
-  const checked = explaining ? _chunkFVZJ4X3Ycjs.checkAiExplanation.call(void 0, raw, one.request) : _chunkFVZJ4X3Ycjs.checkAiHint.call(void 0, raw, one.request);
+  if (one.request.feature === "writing-feedback") {
+    const checked2 = _chunkOPMY2MNScjs.checkAiWritingFeedback.call(void 0, raw, one.request);
+    if (checked2.ok) {
+      const { text, provenance, usage } = checked2.feedback;
+      return {
+        case: one,
+        ok: true,
+        result: {
+          text,
+          ...provenance !== void 0 ? { provenance } : {},
+          ...usage !== void 0 ? { usage } : {}
+        },
+        feedback: checked2.feedback,
+        ms
+      };
+    }
+    return refused(one, raw, checked2.refusal, ms);
+  }
+  const checked = one.request.feature === "explanation" ? _chunkOPMY2MNScjs.checkAiExplanation.call(void 0, raw, one.request) : _chunkOPMY2MNScjs.checkAiHint.call(void 0, raw, one.request);
   if (checked.ok) {
     return { case: one, ok: true, result: checked.result, ms };
   }
+  return refused(one, raw, checked.refusal, ms);
+}
+function refused(one, raw, refusal, ms) {
   const text = typeof _optionalChain([raw, 'optionalAccess', _ => _.text]) === "string" ? raw : void 0;
   return {
     case: one,
     ok: false,
-    refusal: checked.refusal,
+    refusal,
     ...text !== void 0 ? { result: text } : {},
     ms
   };
@@ -210,9 +300,7 @@ async function runAiCheck(ports, options = {}) {
   const all = _nullishCoalesce(options.cases, () => ( aiCheckCases()));
   const asked = Math.trunc(_nullishCoalesce(options.concurrency, () => ( 1)));
   const lanes = Number.isFinite(asked) && asked >= 1 ? Math.min(asked, 16) : 1;
-  const runnable = all.filter(
-    (one) => one.request.feature === "explanation" ? ports.explain !== void 0 : ports.hint !== void 0
-  );
+  const runnable = all.filter((one) => portFor(ports, one) !== void 0);
   const results = new Array(runnable.length);
   let next = 0;
   const lane = async () => {
@@ -229,13 +317,13 @@ async function runAiCheck(ports, options = {}) {
   await Promise.all(Array.from({ length: Math.min(lanes, runnable.length) }, lane));
   const byRefusal = Object.fromEntries(REFUSALS.map((reason) => [reason, 0]));
   let shown = 0;
-  let refused = 0;
+  let refused2 = 0;
   let errors = 0;
   for (const result of results) {
     if (result.ok) {
       shown += 1;
     } else if (result.refusal !== void 0) {
-      refused += 1;
+      refused2 += 1;
       byRefusal[result.refusal] += 1;
     } else {
       errors += 1;
@@ -244,7 +332,7 @@ async function runAiCheck(ports, options = {}) {
   return {
     total: results.length,
     shown,
-    refused,
+    refused: refused2,
     errors,
     skipped: all.length - runnable.length,
     byRefusal,

package/dist/ai-check.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/ai-check.cjs","../src/ai-check/cases.ts","../src/ai-check/index.ts"],"names":[],"mappings":"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","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/ai-check.cjs","sourcesContent":[null,"import { aiExplanationRequest, aiHintRequest } from '../ai.js';\nimport type {\n  DictationData,\n  FillInTheBlanksData,\n  GapSelectData,\n  LearnerResponse,\n  MultipleChoiceData,\n} from '../types/activity.js';\nimport type { AiExplanationRequest, AiHintRequest } from '../types/ai.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 */\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\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';\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;\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 });\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\n/**\n * The cases {@link runAiCheck} runs: every type the SDK explains, answered\n * right, wrong and — where a type can be — partly right; and every type it\n * hints for, before an answer and after a wrong one.\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  ];\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 * });\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.\n */\nimport { checkAiExplanation, checkAiHint } from '../ai.js';\nimport type { AiExplanationRequest, AiHintRequest, AiRefusal, AiTextResult } 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}\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  /** 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];\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 explaining = one.request.feature === 'explanation';\n  const port = explaining ? ports.explain : ports.hint;\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  const checked = explaining\n    ? checkAiExplanation(raw, one.request as AiExplanationRequest)\n    : checkAiHint(raw, one.request as AiHintRequest);\n  if (checked.ok) {\n    return { case: one, ok: true, result: checked.result, ms };\n  }\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: checked.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) =>\n    one.request.feature === 'explanation' ? ports.explain !== undefined : ports.hint !== undefined,\n  );\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"]}
+{"version":3,"sources":["/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/ai-check.cjs","../src/ai-check/cases.ts","../src/ai-check/index.ts"],"names":["checked","refused"],"mappings":"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","file":"/home/runner/work/learning-kit/learning-kit/packages/lk-core/dist/ai-check.cjs","sourcesContent":[null,"import { aiExplanationRequest, aiHintRequest } from '../ai.js';\nimport { aiWritingFeedbackRequest } from '../ai-writing.js';\nimport type {\n  DictationData,\n  FillInTheBlanksData,\n  GapSelectData,\n  LearnerResponse,\n  MultipleChoiceData,\n  WrittenResponseData,\n} from '../types/activity.js';\nimport type { AiExplanationRequest, AiHintRequest, AiWritingFeedbackRequest } from '../types/ai.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\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';\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;\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\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  ];\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 * });\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 — and\n * `misquotes-answer` on a writing case the next: that prompt corrects words the\n * learner never wrote.\n */\nimport { checkAiExplanation, checkAiHint } from '../ai.js';\nimport { checkAiWritingFeedback } from '../ai-writing.js';\nimport type {\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}\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  /** 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];\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    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 === '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"]}

package/dist/ai-check.d.cts

@@ -1,4 +1,4 @@
-import { j as AiExplanationRequest, p as AiHintRequest, u as AiRefusal, w as AiTextResult } from './activity-f0bgZSTP.cjs';
+import { k as AiExplanationRequest, q as AiHintRequest, F as AiWritingFeedbackRequest, v as AiRefusal, y as AiTextResult, E as AiWritingFeedback } from './activity-CYc7SD3d.cjs';
 
 /**
  * One call to make against a host's port, and what a learner was looking at
@@ -8,16 +8,17 @@ interface AiCheckCase {
     /** Stable across releases, so a host can name one in an allow-list or a report. */
     id: string;
     /** Which port the case is for. */
-    feature: 'explanation' | 'hint';
+    feature: 'explanation' | 'hint' | 'writing-feedback';
     /** What the learner did, in a few words, for a report a person reads. */
     about: string;
     /** The request, built by the SDK exactly as a component builds it. */
-    request: AiExplanationRequest | AiHintRequest;
+    request: AiExplanationRequest | AiHintRequest | AiWritingFeedbackRequest;
 }
 /**
  * The cases {@link runAiCheck} runs: every type the SDK explains, answered
- * right, wrong and — where a type can be — partly right; and every type it
- * hints for, before an answer and after a wrong one.
+ * right, wrong and — where a type can be — partly right; every type it hints
+ * for, before an answer and after a wrong one; and drafts of an essay, with
+ * mistakes, without, and revised.
  *
  * They are ordinary calls. What makes them a test is that the SDK knows the
  * answer to each, so it can check what your model writes about it.
@@ -37,6 +38,7 @@ declare function aiCheckCases(): AiCheckCase[];
 interface AiCheckPorts {
     explain?(request: AiExplanationRequest): Promise<unknown> | unknown;
     hint?(request: AiHintRequest): Promise<unknown> | unknown;
+    writingFeedback?(request: AiWritingFeedbackRequest): Promise<unknown> | unknown;
 }
 /** What happened on one case. */
 interface AiCheckResult {
@@ -53,6 +55,8 @@ interface AiCheckResult {
      * nothing the SDK could read.
      */
     result?: AiTextResult;
+    /** For a writing case a learner would have been shown: the feedback, as the SDK accepted it. */
+    feedback?: AiWritingFeedback;
     /** How long the call took, in milliseconds. */
     ms: number;
 }

package/dist/ai-check.d.ts

@@ -1,4 +1,4 @@
-import { j as AiExplanationRequest, p as AiHintRequest, u as AiRefusal, w as AiTextResult } from './activity-f0bgZSTP.js';
+import { k as AiExplanationRequest, q as AiHintRequest, F as AiWritingFeedbackRequest, v as AiRefusal, y as AiTextResult, E as AiWritingFeedback } from './activity-CYc7SD3d.js';
 
 /**
  * One call to make against a host's port, and what a learner was looking at
@@ -8,16 +8,17 @@ interface AiCheckCase {
     /** Stable across releases, so a host can name one in an allow-list or a report. */
     id: string;
     /** Which port the case is for. */
-    feature: 'explanation' | 'hint';
+    feature: 'explanation' | 'hint' | 'writing-feedback';
     /** What the learner did, in a few words, for a report a person reads. */
     about: string;
     /** The request, built by the SDK exactly as a component builds it. */
-    request: AiExplanationRequest | AiHintRequest;
+    request: AiExplanationRequest | AiHintRequest | AiWritingFeedbackRequest;
 }
 /**
  * The cases {@link runAiCheck} runs: every type the SDK explains, answered
- * right, wrong and — where a type can be — partly right; and every type it
- * hints for, before an answer and after a wrong one.
+ * right, wrong and — where a type can be — partly right; every type it hints
+ * for, before an answer and after a wrong one; and drafts of an essay, with
+ * mistakes, without, and revised.
  *
  * They are ordinary calls. What makes them a test is that the SDK knows the
  * answer to each, so it can check what your model writes about it.
@@ -37,6 +38,7 @@ declare function aiCheckCases(): AiCheckCase[];
 interface AiCheckPorts {
     explain?(request: AiExplanationRequest): Promise<unknown> | unknown;
     hint?(request: AiHintRequest): Promise<unknown> | unknown;
+    writingFeedback?(request: AiWritingFeedbackRequest): Promise<unknown> | unknown;
 }
 /** What happened on one case. */
 interface AiCheckResult {
@@ -53,6 +55,8 @@ interface AiCheckResult {
      * nothing the SDK could read.
      */
     result?: AiTextResult;
+    /** For a writing case a learner would have been shown: the feedback, as the SDK accepted it. */
+    feedback?: AiWritingFeedback;
     /** How long the call took, in milliseconds. */
     ms: number;
 }

package/dist/ai-check.js

@@ -1,10 +1,12 @@
 import {
   aiExplanationRequest,
   aiHintRequest,
+  aiWritingFeedbackRequest,
   checkAiExplanation,
-  checkAiHint
-} from "./chunk-BIJCO2HM.js";
-import "./chunk-MMEQKFFQ.js";
+  checkAiHint,
+  checkAiWritingFeedback
+} from "./chunk-5UCR4UNR.js";
+import "./chunk-Q7MV3IXJ.js";
 import "./chunk-D3GP5MET.js";
 
 // src/ai-check/cases.ts
@@ -68,6 +70,23 @@ var listening = {
   title: "Listen and type",
   transcript: "The train leaves at half past nine."
 };
+var weekend = {
+  schemaVersion: "1.0",
+  type: "written-response",
+  id: "ai-check-writing",
+  title: "Your weekend",
+  prompt: "Write a few sentences about what you did last weekend.",
+  minWords: 15,
+  maxWords: 120,
+  languageTarget: "en-A2",
+  rubric: {
+    criteria: [
+      { name: "Grammar", description: "Past tenses, articles, agreement", weight: 2 },
+      { name: "Vocabulary", description: "Everyday words, used correctly", weight: 1 },
+      { name: "Task", description: "Says what the learner did, in order", weight: 1 }
+    ]
+  }
+};
 var chose = (ids) => ({
   type: "multiple-choice",
   selectedOptionIds: ids
@@ -81,6 +100,11 @@ var picked = (choices) => ({
   selections: choices
 });
 var wrote = (text) => ({ type: "dictation", text });
+var drafted = (text) => ({
+  type: "written-response",
+  text,
+  wordCount: 0
+});
 function explanationCase(id, about, data, response) {
   const request = aiExplanationRequest({ data, response });
   if (request === null) {
@@ -95,6 +119,18 @@ function hintCase(id, about, data, response, previousHints = []) {
   }
   return { id, feature: "hint", about, request };
 }
+function writingCase(id, about, text, previousFeedback = [], learnerLocale) {
+  const request = aiWritingFeedbackRequest({
+    data: weekend,
+    response: drafted(text),
+    previousFeedback,
+    ...learnerLocale !== void 0 ? { learnerLocale } : {}
+  });
+  if (request === null) {
+    throw new Error(`ai-check: no writing feedback request for "${id}"`);
+  }
+  return { id, feature: "writing-feedback", about, request };
+}
 function aiCheckCases() {
   return [
     explanationCase("mc-correct", "Chose the right city", capital, chose(["madrid"])),
@@ -161,6 +197,29 @@ function aiCheckCases() {
       landscape,
       picked({ g1: "campo" }),
       ["Piensa en la forma del terreno."]
+    ),
+    writingCase(
+      "writing-mistakes",
+      "A first draft with tense, article and agreement mistakes",
+      "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."
+    ),
+    writingCase(
+      "writing-clean",
+      "A first draft with no mistakes to correct",
+      "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."
+    ),
+    writingCase(
+      "writing-revised",
+      "A second draft that fixed some mistakes",
+      "Last weekend I went to the market and bought a apple. My friends was there too, so we didn't go home early.",
+      ['Check your past tenses: "go" and "buyed" should be past forms.']
+    ),
+    writingCase(
+      "writing-feedback-in-spanish",
+      "A first draft, with feedback asked for in Spanish",
+      "Last weekend I visit my grandmother. She cook a big lunch and we eat together in the garden.",
+      [],
+      "es"
     )
   ];
 }
@@ -171,13 +230,23 @@ var REFUSALS = [
   "empty",
   "too-long",
   "contradicts-grade",
-  "reveals-answer"
+  "reveals-answer",
+  "misquotes-answer"
 ];
+function portFor(ports, one) {
+  switch (one.request.feature) {
+    case "explanation":
+      return ports.explain;
+    case "hint":
+      return ports.hint;
+    default:
+      return ports.writingFeedback;
+  }
+}
 var now = () => Date.now();
 async function runCase(ports, one) {
   const started = now();
-  const explaining = one.request.feature === "explanation";
-  const port = explaining ? ports.explain : ports.hint;
+  const port = portFor(ports, one);
   if (port === void 0) {
     throw new Error(`ai-check: no port for "${one.id}"`);
   }
@@ -193,15 +262,36 @@ async function runCase(ports, one) {
     };
   }
   const ms = now() - started;
-  const checked = explaining ? checkAiExplanation(raw, one.request) : checkAiHint(raw, one.request);
+  if (one.request.feature === "writing-feedback") {
+    const checked2 = checkAiWritingFeedback(raw, one.request);
+    if (checked2.ok) {
+      const { text, provenance, usage } = checked2.feedback;
+      return {
+        case: one,
+        ok: true,
+        result: {
+          text,
+          ...provenance !== void 0 ? { provenance } : {},
+          ...usage !== void 0 ? { usage } : {}
+        },
+        feedback: checked2.feedback,
+        ms
+      };
+    }
+    return refused(one, raw, checked2.refusal, ms);
+  }
+  const checked = one.request.feature === "explanation" ? checkAiExplanation(raw, one.request) : checkAiHint(raw, one.request);
   if (checked.ok) {
     return { case: one, ok: true, result: checked.result, ms };
   }
+  return refused(one, raw, checked.refusal, ms);
+}
+function refused(one, raw, refusal, ms) {
   const text = typeof raw?.text === "string" ? raw : void 0;
   return {
     case: one,
     ok: false,
-    refusal: checked.refusal,
+    refusal,
     ...text !== void 0 ? { result: text } : {},
     ms
   };
@@ -210,9 +300,7 @@ async function runAiCheck(ports, options = {}) {
   const all = options.cases ?? aiCheckCases();
   const asked = Math.trunc(options.concurrency ?? 1);
   const lanes = Number.isFinite(asked) && asked >= 1 ? Math.min(asked, 16) : 1;
-  const runnable = all.filter(
-    (one) => one.request.feature === "explanation" ? ports.explain !== void 0 : ports.hint !== void 0
-  );
+  const runnable = all.filter((one) => portFor(ports, one) !== void 0);
   const results = new Array(runnable.length);
   let next = 0;
   const lane = async () => {
@@ -229,13 +317,13 @@ async function runAiCheck(ports, options = {}) {
   await Promise.all(Array.from({ length: Math.min(lanes, runnable.length) }, lane));
   const byRefusal = Object.fromEntries(REFUSALS.map((reason) => [reason, 0]));
   let shown = 0;
-  let refused = 0;
+  let refused2 = 0;
   let errors = 0;
   for (const result of results) {
     if (result.ok) {
       shown += 1;
     } else if (result.refusal !== void 0) {
-      refused += 1;
+      refused2 += 1;
       byRefusal[result.refusal] += 1;
     } else {
       errors += 1;
@@ -244,7 +332,7 @@ async function runAiCheck(ports, options = {}) {
   return {
     total: results.length,
     shown,
-    refused,
+    refused: refused2,
     errors,
     skipped: all.length - runnable.length,
     byRefusal,