reflex-agent 0.2.4 → 0.3.0

package/packages/utilities/learn-anything/actions/buildModule.ts

@@ -91,77 +91,77 @@ export default async function buildModule(
   // the LLM tells us WHAT to look for / draw; Reflex resolves it via
   // reflex.images.search (Brave when available) + reflex.images.generate.
   const prompt = [
-    `Курс: «${args.topic}». Модуль: «${args.moduleTitle}» — ${args.moduleObjective}.`,
-    "Подготовь учебный материал. Структура JSON-ответа:",
+    `Course: "${args.topic}". Module: "${args.moduleTitle}" — ${args.moduleObjective}.`,
+    "Produce the learning material. JSON reply shape:",
     "{",
-    `  "article": "длинный markdown 800-2000 слов; используй # ## ### и плейсхолдеры [[IMG:<id>]] для inline-картинок",`,
+    `  "article": "long markdown 800-2000 words; use # ## ### and [[IMG:<id>]] placeholders for inline images",`,
     `  "videos": [{"title":"...","url":"https://youtube.com/...","note":"..."}],`,
     `  "links": [{"title":"...","url":"...","snippet":"..."}],`,
-    `  "imageQueries": [{"id":"i1","alt":"...","query":"короткий английский поисковый запрос"}],`,
-    `  "generatedFigures": [{"id":"f1","alt":"...","prompt":"подробное описание для AI-генератора, английский"}],`,
+    `  "imageQueries": [{"id":"i1","alt":"...","query":"short English search query"}],`,
+    `  "generatedFigures": [{"id":"f1","alt":"...","prompt":"detailed English description for the AI generator"}],`,
     `  "diagrams": [{"title":"...","mermaid":"graph TD; A-->B;"}],`,
     `  "homework": ["...","..."]`,
     "}",
     "",
-    "## ВИЗУАЛЬНОЕ СОПРОВОЖДЕНИЕ — ОБЯЗАТЕЛЬНО + INLINE-РАЗМЕЩЕНИЕ",
+    "## VISUAL CONTENT — MANDATORY + INLINE PLACEMENT",
     "",
-    "Любой учебный модуль ОБЯЗАН быть визуально насыщенным. Каждая картинка ставится **inline** в нужном месте текста через плейсхолдер.",
+    "Every learning module MUST be visually rich. Each image is placed **inline** at the right spot in the text via a placeholder.",
     "",
-    "### Как это работает",
-    "  1. Каждому элементу в `imageQueries` и `generatedFigures` присваиваешь ШОРТ-ID (`i1`, `i2`, `f1`, `f2`, ...). i = image-search (real photo), f = figure (AI-generated). Уникальный в пределах модуля.",
-    "  2. В `article` markdown вставляешь плейсхолдер `[[IMG:i1]]` на ОТДЕЛЬНОЙ СТРОКЕ ровно там где должна стоять эта картинка (например, после абзаца который её обсуждает).",
-    "  3. Reflex автоматически:",
-    "     – ищет реальные фото/схемы через Brave Image Search (по `imageQueries`),",
-    "     – ВИЗУАЛЬНО ОЦЕНИВАЕТ кандидатов (твой chat-агент смотрит на thumbnails через Read tool) — клипарт/off-topic отклоняются по содержимому,",
-    "     – генерирует уникальные иллюстрации через Gemini Nano Banana (по `generatedFigures`),",
-    "     – заменяет `[[IMG:<id>]]` на `![alt](локальный-url)` с атрибуцией,",
-    "     – неотрезолвленные id (картинка не найдена / отклонена) удаляются из текста чисто.",
+    "### How it works",
+    "  1. Each entry in `imageQueries` and `generatedFigures` gets a SHORT ID (`i1`, `i2`, `f1`, `f2`, ...). i = image-search (real photo), f = figure (AI-generated). Unique within the module.",
+    "  2. In the `article` markdown insert the placeholder `[[IMG:i1]]` on its OWN LINE exactly where the image should appear (e.g. after the paragraph that discusses it).",
+    "  3. Reflex automatically:",
+    "     – searches for real photos/diagrams via Brave Image Search (using `imageQueries`),",
+    "     – VISUALLY EVALUATES candidates (your chat agent inspects thumbnails via the Read tool) — clipart / off-topic items are rejected based on content,",
+    "     – generates unique illustrations via Gemini Nano Banana (using `generatedFigures`),",
+    "     – replaces `[[IMG:<id>]]` with `![alt](local-url)` plus attribution,",
+    "     – unresolved ids (image not found / rejected) are cleanly stripped from the text.",
     "",
-    "### Пример",
+    "### Example",
     "```markdown",
-    "## Зрительная кора",
-    "Зрительная кора V1 — первая зона обработки информации от сетчатки.",
+    "## Visual cortex",
+    "The primary visual cortex V1 is the first area that processes information from the retina.",
     "",
     "[[IMG:i1]]",
     "",
-    "Колончатая организация V1 была описана Хьюбелом и Визелом в 1962 году...",
+    "The columnar organisation of V1 was described by Hubel and Wiesel in 1962...",
     "",
     "[[IMG:f1]]",
     "```",
-    "...где `imageQueries: [{id:\"i1\", alt:\"Срез зрительной коры V1\", query:\"primary visual cortex V1 histology\"}]` и `generatedFigures: [{id:\"f1\", alt:\"Схема рецептивного поля\", prompt:\"educational diagram: receptive field of simple cells in V1, ON-OFF regions, labeled in English\"}]`.",
+    "...where `imageQueries: [{id:\"i1\", alt:\"Section of the primary visual cortex V1\", query:\"primary visual cortex V1 histology\"}]` and `generatedFigures: [{id:\"f1\", alt:\"Receptive field diagram\", prompt:\"educational diagram: receptive field of simple cells in V1, ON-OFF regions, labeled in English\"}]`.",
     "",
-    "Твоя задача — заполнить два массива И расставить плейсхолдеры в article:",
+    "Your job is to fill both arrays AND place the placeholders in `article`:",
     "",
-    "### `imageQueries` (поиск реальных материалов) — МИНИМУМ 2-3 шт.",
-    "  • Для тем где есть реальные референсы (Эйфелева башня, клетка, Гражданская война, лабораторная установка, известная картина, ландшафт, исторический документ) — ВСЕГДА добавляй 2-4 query.",
-    "  • Каждый query — короткий АНГЛИЙСКИЙ поисковый запрос (Brave работает лучше на английском): \"Eiffel Tower iron lattice closeup\", \"mitochondria electron microscope\", \"American Civil War Gettysburg battlefield\".",
-    "  • `id` — короткий уникальный идентификатор: `i1`, `i2`, `i3`...",
-    "  • `alt` — короткое описание по-русски, что зритель увидит.",
-    "  • Каждому `id` соответствует ровно один плейсхолдер `[[IMG:i1]]` в `article` — ставь его в тематически подходящем месте.",
+    "### `imageQueries` (real-image search) — AT LEAST 2-3 items.",
+    "  • For topics with real-world references (Eiffel Tower, a cell, the Civil War, lab equipment, a famous painting, a landscape, a historical document) — ALWAYS add 2-4 queries.",
+    "  • Each `query` is a short ENGLISH search string (Brave works best in English): \"Eiffel Tower iron lattice closeup\", \"mitochondria electron microscope\", \"American Civil War Gettysburg battlefield\".",
+    "  • `id` — short unique identifier: `i1`, `i2`, `i3`...",
+    "  • `alt` — short description of what the viewer will see.",
+    "  • Each `id` corresponds to exactly one `[[IMG:i1]]` placeholder in `article` — put it in a thematically appropriate spot.",
     "",
-    "### `generatedFigures` (AI-генерация уникальных схем) — 1-2 шт когда уместно.",
-    "  • Используй для уникальных схем/иллюстраций, которых нет в сети: \"процесс N в виде наглядной схемы\", \"анатомия Х в стиле учебника\", \"таймлайн событий\", \"абстрактная визуализация концепции\".",
-    "  • `id` — короткий уникальный идентификатор: `f1`, `f2`...",
-    "  • `prompt` — подробный АНГЛИЙСКИЙ описательный prompt со стилем (\"minimalist educational diagram, white background, labeled parts in blue, isometric view\" / \"watercolor illustration, soft palette\" / \"photorealistic, studio lighting\").",
-    "  • НЕ дублируй generatedFigures с imageQueries — generate только то, что не найти готовым.",
-    "  • `alt` — короткое описание по-русски.",
-    "  • Поставь плейсхолдер `[[IMG:f1]]` в article ровно где эта схема нужна.",
+    "### `generatedFigures` (AI-generated unique figures) — 1-2 items when appropriate.",
+    "  • Use for unique schemes/illustrations that aren't available online: \"process N as a clear schematic\", \"anatomy of X in textbook style\", \"event timeline\", \"abstract visualisation of a concept\".",
+    "  • `id` — short unique identifier: `f1`, `f2`...",
+    "  • `prompt` — detailed ENGLISH descriptive prompt including style (\"minimalist educational diagram, white background, labeled parts in blue, isometric view\" / \"watercolor illustration, soft palette\" / \"photorealistic, studio lighting\").",
+    "  • DO NOT duplicate generatedFigures with imageQueries — only generate what cannot be found ready-made.",
+    "  • `alt` — short description.",
+    "  • Place the `[[IMG:f1]]` placeholder in `article` exactly where the figure is needed.",
     "",
-    "### Правила для прочих полей",
-    "  • article — основной текст, 800-2000 слов. Заголовки # ## ###, плотный материал.",
-    "  • Картинки размещаются ТОЛЬКО через `[[IMG:<id>]]` на отдельной строке. Не пиши `[[ИЛЛЮСТРАЦИЯ: ...]]`, `[[СХЕМА: ...]]` — они не работают.",
-    "  • НЕ ВЫДУМЫВАЙ URL картинок. Любые bare URL в article игнорируются.",
-    "  • Каждый id, объявленный в imageQueries/generatedFigures, должен встретиться в article ровно один раз. Каждый `[[IMG:<id>]]` в тексте должен иметь соответствие в одном из массивов.",
-    "  • videos: 1-3 ссылки на youtube/youtu.be — URL юзер сам проверит.",
-    "  • links: 2-5 авторитетных статей.",
-    "  • diagrams (mermaid): только flowchart/sequence/class — где mermaid реально удобнее картинки. Для visual schemes используй generatedFigures.",
-    "  • homework: 3-5 практических заданий с проверяемым результатом.",
+    "### Rules for the other fields",
+    "  • article — main text, 800-2000 words. Headings # ## ###, dense content.",
+    "  • Images are placed ONLY via `[[IMG:<id>]]` on its own line. Do not write `[[ILLUSTRATION: ...]]`, `[[DIAGRAM: ...]]` — they don't work.",
+    "  • DO NOT MAKE UP image URLs. Any bare URL in `article` is ignored.",
+    "  • Every id declared in imageQueries/generatedFigures must appear in `article` exactly once. Every `[[IMG:<id>]]` in the text must have a matching entry in one of the arrays.",
+    "  • videos: 1-3 youtube/youtu.be links — the user verifies URLs themselves.",
+    "  • links: 2-5 authoritative articles.",
+    "  • diagrams (mermaid): only flowchart/sequence/class — where mermaid is genuinely more convenient than an image. For visual schemes use generatedFigures.",
+    "  • homework: 3-5 practical exercises with a verifiable result.",
     "",
-    "Верни ТОЛЬКО JSON одной строкой, без markdown-фенс.",
+    "Reply with JSON ONLY on a single line, no markdown fences.",
     "",
     webContext
-      ? `## Web-источники для опоры\n${webContext}`
-      : "## Web-источники недоступны — опирайся на свои знания.",
+      ? `## Web sources to ground on\n${webContext}`
+      : "## Web sources unavailable — rely on your own knowledge.",
   ].join("\n");
 
   const result = await callJsonAgent<LlmDraft>({
@@ -170,7 +170,7 @@ export default async function buildModule(
     maxAttempts: 4,
     shapeHint:
       `{"article":"...","videos":[],"links":[],"imageQueries":[],"generatedFigures":[],"diagrams":[],"homework":[]}\n` +
-      `article — markdown 800-2000 слов. Все массивы — обязательно массивы (можно пустые).`,
+      `article — markdown 800-2000 words. Every list field must be an array (empty is OK).`,
     validate: (p) => {
       const v = p as LlmDraft;
       return typeof v?.article === "string" && v.article.trim().length > 40
@@ -180,8 +180,8 @@ export default async function buildModule(
   });
   if (!result.ok) {
     throw new Error(
-      `Не удалось собрать модуль за ${result.attempts} попыток (${result.reason}). ` +
-        `Последний ответ: «${snippet(result.lastText, 200)}».`,
+      `Failed to build the module in ${result.attempts} attempts (${result.reason}). ` +
+        `Last reply: "${snippet(result.lastText, 200)}".`,
     );
   }
   const draft = result.value;
@@ -196,8 +196,9 @@ export default async function buildModule(
 
   // Inline-place images by substituting [[IMG:<id>]] placeholders in the
   // article body. Any image whose id wasn't referenced (LLM forgot)
-  // falls back into the trailing Иллюстрации section so nothing gets
-  // dropped silently. Residual unknown [[...]] markers are stripped.
+  // falls back into the trailing "Additional illustrations" section so
+  // nothing gets dropped silently. Residual unknown [[...]] markers are
+  // stripped.
   const allImages = [...searchedImages, ...generatedImages];
   const { article: articleWithImages, placedIds } = substituteImagePlaceholders(
     typeof draft.article === "string" ? draft.article : "",
@@ -226,13 +227,13 @@ export default async function buildModule(
   const body = [
     content.article,
     unplaced.length > 0
-      ? "\n\n## Дополнительные иллюстрации\n" +
+      ? "\n\n## Additional illustrations\n" +
         unplaced
           .map((im) => `${renderInlineImage(im)}`)
           .join("\n\n")
       : "",
     content.diagrams.length > 0
-      ? "\n\n## Схемы\n" +
+      ? "\n\n## Diagrams\n" +
         content.diagrams
           .map(
             (d) =>
@@ -395,24 +396,24 @@ function renderInlineImage(im: ModuleContent["images"][number]): string {
   const safeAlt = im.alt.replace(/[\[\]\n]/g, " ").slice(0, 200);
   const credit =
     im.source === "search" && im.attribution?.name
-      ? `\n\n_Источник: [${im.attribution.name}](${im.attribution.link || im.url})_`
+      ? `\n\n_Source: [${im.attribution.name}](${im.attribution.link || im.url})_`
       : im.source === "generated"
-        ? `\n\n_Сгенерировано AI_`
+        ? `\n\n_Generated by AI_`
         : "";
   return `![${safeAlt}](${im.url})${credit}`;
 }
 
 /**
- * Strip residual `[[ИЛЛЮСТРАЦИЯ: ...]]` / `[[СХЕМА: ...]]` / orphan
+ * Strip residual `[[ILLUSTRATION: ...]]` / `[[DIAGRAM: ...]]` / orphan
  * `[[IMG:<unknown-id>]]` placeholders the LLM might emit despite the
  * prompt forbidding them OR after `substituteImagePlaceholders` failed
  * to find the id. Drops the marker, collapses surrounding whitespace.
  *
- * Matches Russian variants + Latin spellings for safety. Case-insensitive.
+ * Matches several spelling variants for safety. Case-insensitive.
  */
 function stripPlaceholderMarkers(text: string): string {
   const re =
-    /\[\[?\s*(?:ИЛЛЮСТРАЦИЯ|СХЕМА|ILLUSTRATION|SCHEME|IMAGE|IMG|DIAGRAM)\b[^\]]*?\]\]?/giu;
+    /\[\[?\s*(?:ILLUSTRATION|SCHEME|IMAGE|IMG|DIAGRAM)\b[^\]]*?\]\]?/giu;
   let out = text.replace(re, "");
   // Clean up double blank lines + trailing whitespace the removal may
   // have left behind.

package/packages/utilities/learn-anything/actions/explainSelection.ts

@@ -3,15 +3,16 @@ import { reflex } from "@host/api";
 /**
  * "Explain this" feature: user highlights a snippet inside the module
  * article and asks for a deeper explanation. The agent gets the
- * surrounding paragraph as context so it understands what "это" means.
+ * surrounding paragraph as context so it understands what "this" means.
  *
  * Two modes:
  *   1. Default — `question` omitted, agent gives a generic 2-5 paragraph
  *      breakdown of the selected fragment.
  *   2. Custom — `question` supplied (book-style margin annotation), agent
  *      answers that specific question with the selection as the focal
- *      point. Lets the reader say things like "при чём тут N?" or
- *      "дай пример" instead of always getting the same boilerplate.
+ *      point. Lets the reader say things like "what does N have to do
+ *      with this?" or "give me an example" instead of always getting the
+ *      same boilerplate.
  */
 
 export interface ExplainSelectionArgs {
@@ -29,31 +30,31 @@ export default async function explainSelection(
 ): Promise<{ text: string }> {
   const userQuestion = (args.question ?? "").trim();
   const promptLines: string[] = [
-    `Курс: «${args.topic}». Модуль: «${args.moduleTitle}».`,
+    `Course: "${args.topic}". Module: "${args.moduleTitle}".`,
   ];
 
   if (userQuestion) {
     promptLines.push(
-      "Пользователь выделил фрагмент и задал конкретный вопрос про этот фрагмент.",
-      "Ответь именно на его вопрос, опираясь на выделение + окружающий контекст. 2-4 абзаца, без воды, по делу.",
-      "Markdown без заголовков; короткие фразы, пример если уместен.",
+      "The user highlighted a fragment and asked a specific question about that fragment.",
+      "Answer exactly their question, grounded in the selection + surrounding context. 2-4 paragraphs, no fluff, to the point.",
+      "Markdown without headings; short sentences, with an example when appropriate.",
     );
   } else {
     promptLines.push(
-      "Пользователь выделил фрагмент и просит объяснить подробнее.",
-      "Дай развёрнутое объяснение в 2-5 абзацах: что это значит, как работает,",
-      "почему именно так, конкретный пример. Без воды. Markdown без заголовков.",
+      "The user highlighted a fragment and is asking for a deeper explanation.",
+      "Give a thorough explanation in 2-5 paragraphs: what it means, how it works,",
+      "why it works that way, with a concrete example. No fluff. Markdown without headings.",
     );
   }
 
   promptLines.push(
     "",
-    `## Окружающий контекст\n${args.context.slice(0, 1500)}`,
+    `## Surrounding context\n${args.context.slice(0, 1500)}`,
     "",
-    `## Выделение пользователя\n«${args.selection.slice(0, 800)}»`,
+    `## User selection\n"${args.selection.slice(0, 800)}"`,
   );
   if (userQuestion) {
-    promptLines.push("", `## Вопрос пользователя\n${userQuestion.slice(0, 600)}`);
+    promptLines.push("", `## User question\n${userQuestion.slice(0, 600)}`);
   }
 
   const r = await reflex.llm.complete({

package/packages/utilities/learn-anything/actions/generateOutline.ts

@@ -38,20 +38,20 @@ export default async function generateOutline(
     .map((qa) => `Q: ${qa.question}\nA: ${qa.answer}`)
     .join("\n\n");
   const prompt = [
-    "Составь учебный курс по теме «${TOPIC}» под пользователя с такими ответами:".replace(
+    "Design a learning course on the topic \"${TOPIC}\" tailored to a user with the following answers:".replace(
       "${TOPIC}",
       args.topic,
     ),
     "",
-    prior || "(нет ответов)",
+    prior || "(no answers)",
     "",
-    "Требования:",
-    "  • 5-9 модулей, от базовых к продвинутым.",
-    "  • Каждый модуль самодостаточен (можно открыть и пройти за один присест).",
-    "  • objective — одна точная фраза «к концу модуля ты сможешь …».",
-    "  • estMinutes — реалистичная оценка чистого времени учёбы (15-60).",
-    "  • id модуля — kebab-case, латиница+цифры.",
-    "Верни ТОЛЬКО JSON одной строкой, без markdown:",
+    "Requirements:",
+    "  • 5-9 modules, from basic to advanced.",
+    "  • Each module is self-contained (can be opened and completed in one sitting).",
+    "  • objective — one precise phrase \"by the end of this module you will be able to …\".",
+    "  • estMinutes — a realistic estimate of pure study time (15-60).",
+    "  • module id — kebab-case, latin letters + digits.",
+    "Reply with JSON ONLY on a single line, no markdown:",
     `  {"modules":[{"id":"intro","title":"…","objective":"…","estMinutes":30}, ...]}`,
   ].join("\n");
 
@@ -60,8 +60,8 @@ export default async function generateOutline(
     invoke: (p) => reflex.agent.invoke({ prompt: p, timeoutMs: 4 * 60_000 }),
     maxAttempts: 4,
     shapeHint:
-      `{"modules":[{"id":"intro","title":"Введение","objective":"к концу модуля сможешь …","estMinutes":30}, ...]}\n` +
-      `Минимум 5 модулей. id — kebab-case, без пробелов и кириллицы.`,
+      `{"modules":[{"id":"intro","title":"Introduction","objective":"by the end of this module you will be able to …","estMinutes":30}, ...]}\n` +
+      `At least 5 modules. id — kebab-case, no spaces, latin letters only.`,
     validate: (parsed) => {
       const v = parsed as { modules?: unknown };
       const modules = sanitizeModules(v?.modules);
@@ -71,8 +71,8 @@ export default async function generateOutline(
 
   if (!result.ok) {
     throw new Error(
-      `Не удалось собрать программу курса за ${result.attempts} попыток (${result.reason}). ` +
-        `Последний ответ агента: «${snippet(result.lastText, 200)}». Попробуй переформулировать тему.`,
+      `Failed to build the course outline in ${result.attempts} attempts (${result.reason}). ` +
+        `Last agent reply: "${snippet(result.lastText, 200)}". Try rephrasing the topic.`,
     );
   }
   const modules = result.value;
@@ -82,11 +82,11 @@ export default async function generateOutline(
   const body = [
     `# ${args.topic}`,
     "",
-    "## Программа",
+    "## Program",
     "",
     ...modules.map(
       (mod, i) =>
-        `${i + 1}. **${mod.title}** — ${mod.objective} (~${mod.estMinutes} мин)`,
+        `${i + 1}. **${mod.title}** — ${mod.objective} (~${mod.estMinutes} min)`,
     ),
   ].join("\n");
 

package/packages/utilities/learn-anything/actions/generateQuiz.ts

@@ -28,16 +28,16 @@ export default async function generateQuiz(
 ): Promise<{ questions: QuizQuestion[] }> {
   const trimmed = (args.article ?? "").slice(0, 6000);
   const prompt = [
-    `Модуль: «${args.moduleTitle}» — ${args.moduleObjective}.`,
-    "Составь короткий тест-проверку из 5 вопросов с 4 вариантами ответа.",
-    "Правила:",
-    "  • Вопросы — на понимание, не на запоминание мелочей.",
-    "  • Только один правильный ответ; остальные правдоподобные.",
-    "  • Объяснение почему правильный — 1-2 фразы.",
-    "Верни ТОЛЬКО JSON одной строкой:",
+    `Module: "${args.moduleTitle}" — ${args.moduleObjective}.`,
+    "Compose a short knowledge-check quiz of 5 questions with 4 answer options each.",
+    "Rules:",
+    "  • Questions test understanding, not rote memorisation of trivia.",
+    "  • Exactly one correct answer; the others are plausible.",
+    "  • Explanation of why the answer is correct — 1-2 sentences.",
+    "Reply with JSON ONLY on a single line:",
     `  {"questions":[{"stem":"...","options":["a","b","c","d"],"correctIndex":0,"explanation":"..."}, ...]}`,
     "",
-    `## Материал модуля\n${trimmed}`,
+    `## Module material\n${trimmed}`,
   ].join("\n");
 
   const r = await reflex.llm.complete({ task: "quick", prompt });

package/packages/utilities/learn-anything/actions/generateTrainer.ts

@@ -35,21 +35,21 @@ export default async function generateTrainer(
 ): Promise<TrainerSpec> {
   const userBrief =
     (args.prompt ?? "").trim() ||
-    `Спроектируй тренажёр, который помогает закрепить «${args.moduleObjective}».`;
+    `Design a trainer that helps reinforce "${args.moduleObjective}".`;
   const prompt = [
-    `Курс/модуль: «${args.moduleTitle}».`,
-    "Сделай интерактивный тренажёр — отдельный HTML-файл с inline JS.",
-    "Требования:",
-    "  • Один <!doctype html> файл целиком: <head>, <body>, <script>, опционально <style>.",
-    "  • НИКАКИХ внешних ресурсов: ни CDN-скриптов, ни картинок по URL, ни fetch'ей. Всё inline.",
-    "  • Используй <canvas> где это уместно (рисование, физика, геометрия).",
-    "  • Размер ≈ 600×400 px (адаптивно).",
-    "  • Чёткий interface: что показано, что делать, мгновенный feedback (правильно/нет, score).",
-    "  • Без navigator/window глобалов которые ломаются в sandbox iframe (без localStorage, без parent).",
-    "  • КОД ДОЛЖЕН РАБОТАТЬ. Никаких placeholder-функций.",
-    "Верни ТОЛЬКО HTML (без обёртки JSON и без markdown-fence).",
+    `Course/module: "${args.moduleTitle}".`,
+    "Build an interactive trainer — a standalone HTML file with inline JS.",
+    "Requirements:",
+    "  • One full <!doctype html> file: <head>, <body>, <script>, optional <style>.",
+    "  • NO external resources: no CDN scripts, no image URLs, no fetch calls. Everything inline.",
+    "  • Use <canvas> where appropriate (drawing, physics, geometry).",
+    "  • Size ≈ 600×400 px (responsive).",
+    "  • Clear interface: what is shown, what to do, instant feedback (right/wrong, score).",
+    "  • No navigator/window globals that break inside a sandbox iframe (no localStorage, no parent).",
+    "  • THE CODE MUST WORK. No placeholder functions.",
+    "Reply with HTML ONLY (no JSON wrapper, no markdown fence).",
     "",
-    `## Идея тренажёра\n${userBrief}`,
+    `## Trainer idea\n${userBrief}`,
   ].join("\n");
 
   // Trainer HTML is long — give the agent a generous 7 minutes; worker
@@ -58,13 +58,13 @@ export default async function generateTrainer(
   const text = r.text ?? "";
   const html = extractHtml(text);
   if (!html) {
-    throw new Error("Агент не вернул валидный HTML — попробуй ещё раз");
+    throw new Error("Agent did not return valid HTML — please try again");
   }
 
   const trainerId = `${args.moduleId}-${Date.now().toString(36)}`;
   const saved = await reflex.kb.add({
     kind: "course-trainer",
-    title: `Тренажёр · ${args.moduleTitle}`,
+    title: `Trainer · ${args.moduleTitle}`,
     body: "```html\n" + html.slice(0, 30_000) + "\n```",
     meta: {
       courseId: args.courseId,

package/packages/utilities/learn-anything/actions/refreshCourseCard.ts

@@ -32,14 +32,14 @@ export default async function refreshCourseCard(): Promise<{ courses: number; av
   await reflex.cards.update({
     snapshot: {
       kind: "kpi",
-      title: "🎓 Учусь",
+      title: "🎓 Learning",
       data: {
         items: [
-          { label: "Активных курсов", value: String(courses) },
+          { label: "Active courses", value: String(courses) },
           {
-            label: "Прогресс",
+            label: "Progress",
             value: courses === 0 ? "—" : `${avg}%`,
-            hint: "среднее по курсам",
+            hint: "average across courses",
             ...(avg >= 60
               ? ({ delta: "up" } as const)
               : avg < 30 && courses > 0

package/packages/utilities/learn-anything/actions/tutorAsk.ts

@@ -8,8 +8,8 @@ import { extractJson } from "./_json";
  * `{done:true}` so the UI advances to outline generation.
  *
  * Keeping the wizard agent-driven means we don't hardcode "3 questions
- * about level/focus/format" — for "хочу научиться рисовать карандашом"
- * the agent will ask different questions than for "хочу выучить
+ * about level/focus/format" — for "I want to learn pencil drawing"
+ * the agent will ask different questions than for "I want to learn
  * Python". The UI just renders whatever comes back.
  */
 
@@ -22,7 +22,7 @@ export interface TutorAskArgs {
   topic: string;
   history: TutorQA[];
   /** Force-finish even if the agent wants more. UI uses this when the
-   *  user clicks "Хватит вопросов — давай уже курс". */
+   *  user clicks "Enough questions — build the course already". */
   forceFinish?: boolean;
 }
 
@@ -32,7 +32,7 @@ export interface TutorAskResult {
   question?: string;
   /** Optional pre-baked choices for a multiple-choice ask. */
   choices?: string[];
-  /** Hint to UI: short label like "уровень", "формат", "цель". */
+  /** Hint to UI: short label like "level", "format", "goal". */
   header?: string;
 }
 
@@ -51,19 +51,19 @@ export default async function tutorAsk(
     .join("\n\n");
 
   const prompt = [
-    "Ты — наставник, который собирается составить персональный курс для пользователя.",
-    `Тема: «${args.topic}».`,
-    "Тебе нужно собрать минимум информации, чтобы хорошо подобрать программу: уровень, цель, время, формат, специфика.",
-    "Задавай по ОДНОМУ вопросу за раз. Решай сам какой именно — то что важнее всего сейчас, исходя из темы и предыдущих ответов.",
-    "Если есть смысл предложить варианты ответа — добавь до 5 коротких choices.",
-    "Если ты уже знаешь достаточно (обычно после 2-4 вопросов) — верни done=true.",
-    "Ответь ТОЛЬКО JSON одной строкой, без markdown:",
-    `  {"done":false,"question":"...","header":"уровень|цель|время|формат|...","choices":["...","..."]}`,
-    "  или",
+    "You are a tutor who is about to design a personalised course for the user.",
+    `Topic: "${args.topic}".`,
+    "You need to gather the minimum information required to choose a good program: level, goal, time budget, format, specifics.",
+    "Ask ONE question at a time. Decide what to ask yourself — whatever is most important right now given the topic and prior answers.",
+    "If it makes sense to offer answer options — add up to 5 short choices.",
+    "If you already know enough (usually after 2-4 questions) — return done=true.",
+    "Reply with JSON ONLY on a single line, no markdown:",
+    `  {"done":false,"question":"...","header":"level|goal|time|format|...","choices":["...","..."]}`,
+    "  or",
     `  {"done":true}`,
     "",
-    prior ? `## Предыдущие ответы\n${prior}` : "## Это первый вопрос",
-    `\nЗадано вопросов до сих пор: ${turns} (максимум ${MAX_TURNS}).`,
+    prior ? `## Previous answers\n${prior}` : "## This is the first question",
+    `\nQuestions asked so far: ${turns} (maximum ${MAX_TURNS}).`,
   ].join("\n");
 
   const r = await reflex.llm.complete({ task: "quick", prompt });

package/packages/utilities/learn-anything/article-view.tsx

@@ -74,7 +74,7 @@ export function ArticleView({
           node.style.fontFamily = "inherit";
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
-          node.innerHTML = `<div class="text-xs text-red-600 not-italic">⚠ Не удалось отрисовать схему: ${escapeHtml(msg)}</div><pre class="mt-2 text-[11px] text-slate-700 whitespace-pre-wrap">${escapeHtml(src)}</pre>`;
+          node.innerHTML = `<div class="text-xs text-red-600 not-italic">⚠ Failed to render diagram: ${escapeHtml(msg)}</div><pre class="mt-2 text-[11px] text-slate-700 whitespace-pre-wrap">${escapeHtml(src)}</pre>`;
           node.classList.add("reflex-mermaid-done");
         }
       }
@@ -100,7 +100,7 @@ export function ArticleView({
           <img
             src={url}
             alt={safeAlt}
-            title={safeAlt || "Открыть на весь экран"}
+            title={safeAlt || "Open fullscreen"}
             loading="lazy"
             onClick={() => setZoom({ src: url, alt: safeAlt })}
             className="my-5 rounded-lg border bg-white max-w-full h-auto cursor-zoom-in transition hover:opacity-90"
@@ -164,7 +164,7 @@ export function ArticleImageLightbox({
     <div
       onClick={onClose}
       role="dialog"
-      aria-label={alt || "Просмотр изображения"}
+      aria-label={alt || "Image preview"}
       style={{
         position: "fixed",
         inset: 0,
@@ -184,7 +184,7 @@ export function ArticleImageLightbox({
           e.stopPropagation();
           onClose();
         }}
-        aria-label="Закрыть"
+        aria-label="Close"
         style={{
           position: "absolute",
           top: 16,

package/packages/utilities/learn-anything/manifest.json

@@ -1,19 +1,19 @@
 {
   "id": "learn-anything",
-  "name": "🎓 Изучи что угодно",
+  "name": "🎓 Learn Anything",
   "version": "0.4.7",
-  "description": "Универсальный AI-наставник: курсы под твой уровень с контентом, тестами и тренажёрами",
+  "description": "Universal AI tutor: courses tailored to your level with content, quizzes, and trainers",
   "author": "reflex-org",
   "category": "study",
   "ui": "ui.tsx",
   "icon": "lucide:GraduationCap",
   "card": {
     "kind": "kpi",
-    "title": "🎓 Учусь",
+    "title": "🎓 Learning",
     "data": {
       "items": [
-        { "label": "Активных курсов", "value": "0" },
-        { "label": "Прогресс", "value": "—", "hint": "среднее по курсам" }
+        { "label": "Active courses", "value": "0" },
+        { "label": "Progress", "value": "—", "hint": "average across courses" }
       ]
     }
   },