Журнал змін
Поточна версія — 1.0.0-beta.13. Журнал змін ведемо англійською.
Правила
Versioning policy (FR-032): [semver](https://semver.org). Agents and their operators depend on tool names, input fields and result fields, so:
- Major — a tool, an input field or a result field is removed, renamed, or changes meaning; a required input field is added.
- Minor — a tool is added; an optional input field or a result field is added.
- Patch — descriptions, documentation and fixes that do not change a shape.
A pre-release (-beta.N) may break any of this, and says so here.
Every release bumps version.ts and adds an entry below, newest first.
Unreleased — 2026-11-01
- `quota_exceeded` now carries
details.limit(weekly|daily) anddetails.resetsAt(ISO UTC); the message names the time in UTC. There is no lesson count any more: AI work is gated by a daily safety limit.rate_limitedis unchanged. - Changed. Blocks per worksheet: 40 → 15 (
tutor_get_block_schema→limits.blocksPerWorksheet). The rule holds for every way of adding a block, not onlytutor_create_lesson. Worksheets that already hold more keep working; only adding is refused. - `tutor_add_block` answers
limit_reachedwith a new optionallimitfield when the worksheet is full, and a problem atworksheetId. Put the block on another worksheet. - `tutor_create_lesson` reports every worksheet over 15 blocks at once, each with its path and count, and creates nothing.
- Changed. Blocks per worksheet: 15 → 20 (
tutor_get_block_schema→limits.blocksPerWorksheet).tutor_add_blockanswerslimit_reachedfor the 21st block, andtutor_create_lessonreports sheets over 20. Worksheets that hold more keep working. - Authoring guide. The vocabulary note now says
expressionholds only the word or phrase (with its article); plural, government and usage notes go with the meaning. - Changed. The
gap-no-base-wordwarning is now one per block (have= the number of gaps,text= their numbers), and is not given when the block's instruction says the answer is several words («lassen», «інфінітив», «два слова»). - Warnings gain three rules:
matching-duplicate,passage-scriptandgap-no-base-word, and two optional fields,textanditemId.tutor_create_lessonandtutor_add_worksheetreturn them whether or not a template is named;tutor_add_blockandtutor_update_blockhave a new optionalwarningsresult (an update of only the key is checked against the saved content). A warning never stops a save.
1.0.0-beta.13 — 2026-10-28
Breaking (pre-release). Mentor no longer writes lesson content on a tool call: the agent writes it, and Mentor stores it. Read /mcp/authoring-guide.md or call tutor_get_authoring_guide first.
- Removed (switched off, not deleted).
tutor_generate_lessonandtutor_get_generation_statusare no longer intools/list; a call to either answers the newnot_availableerror. TheneedsGenerationfield is gone from the block-edit result. - Added tools.
tutor_get_block,tutor_add_worksheet,tutor_read_source,tutor_get_authoring_guide,tutor_archive_course. - Added fields.
template,courseandwarningsontutor_create_lesson;templateandwarningsontutor_add_worksheet;briefForontutor_get_courseand itsbriefresult;authoringontutor_get_block_schema. Warnings never block a save. - New error.
not_available: the tool exists but is switched off on this server; use the tool the message names, do not retry. - Changed. The block-edit rule: a block is edited by writing its content, with no regeneration.
- Folded in (from Unreleased). - A refusal because of the teacher's plan (spec 114) is a
limit_reachederror whose result has a new optional field,details:{ error: "teacher_plan_limit", kind: "lessons" | "students", limit, plan, message }. Nothing was created and nothing existing changed; the agent must not retry, and tells the teacher where the plans are. - The assistant (spec 106) calls the same tools in process, as a new principal kind,assistant: it is not a token, it has the teacher's own scopes and its calls are written to the call log withsource = 'assistant'.
1.0.0-beta.12 — 2026-10-11
Wording only: the product calls the person who uses it «викладач», not «вчитель». The tutor_archive_lesson description and the Ukrainian docs text say so. No tool, input or result field changed.
1.0.0-beta.11 — 2026-10-08
Reshaping a lesson that already exists: an agent could add and remove blocks but not copy a lesson, change what a sheet is for, or remove a sheet, so a taught lesson could not be turned into a self-study one without the teacher doing it by hand.
- New tools.
tutor_copy_lesson(a whole copy under an optionaltitle; returns the new lesson's sheets withid,title,purpose,blockCount),tutor_update_worksheet(titleand/orpurposeof a sheet) andtutor_delete_worksheet(archives a sheet; a lesson's last live sheet is refused). - A lesson holds one live sheet per purpose, so setting a purpose another live sheet already has fails with
conflict; remove or retarget that sheet first. - HTTP 409 from the shared services now maps to
conflictinstead ofvalidation_failed.
1.0.0-beta.10 — 2026-10-08
Tool hints corrected after the ChatGPT tool scan; no input or result changes.
tutor_generate_lesson:openWorldHint: true(it fetches article and YouTube links and calls an AI model).tutor_update_lesson,tutor_update_course,tutor_update_image:destructiveHint: true(they overwrite or clear fields, and an image's alt text changes in every block that shows it).tutor_publish:destructiveHint: true(it makes a course public, and unpublishing removes it).
1.0.0-beta.9 — 2026-10-08
tutor_upload_images: each entry offilesnow declaresdownload_urlandfile_idas required, matching ChatGPT's documented file schema (the plugin tool scan rejected the schema without it).
1.0.0-beta.8 — 2026-10-09
Images in lessons.
- New tools.
tutor_upload_images(modesurl,file,link,drop),tutor_get_upload,tutor_list_images,tutor_update_image(alt text) andtutor_delete_image(confirm: truerequired; without it the tool lists where the image is used and deletes nothing). - Block content takes images by reference.
content.images(up to 5) onopen_prompt,writing,gap_fill,theoryandpassage;imageonmcqquestions,matchingleft items andvocabularyitems;content.imageSlot { want }for a picture the teacher adds later. An image is{ "assetId": "…" }; the server fills the rest and refuses an unknown id with the path of the field. - ChatGPT files.
tutor_upload_imagescarries_meta["openai/fileParams"] = ["files"]. tutor_get_block_schemadescribes the image fields;tutor_get_lessonreturnspreviewUrlnext to every image.- New error codes
link_expiredandfetch_refused.
1.0.0-beta.7 — 2026-10-04
tutor_update_lessontakes an optionalworksheetTitle: the title of the lesson's first sheet, so a sheet title can be changed without recreating the lesson.
1.0.0-beta.6 — 2026-10-04
Sign-in with OAuth (ChatGPT and other MCP clients), and lessons generated for a course.
resource_metadata="…" on 401, /.well-known/oauth-protected-resource/api/mcp` (RFC 9728) and
- OAuth 2.1. Besides a personal token, a client may now sign the teacher in: authorization code + PKCE (S256), public clients only. Discovery:
WWW-Authenticate: Bearer/.well-known/oauth-authorization-server(RFC 8414). Clients register with a client ID metadata document (an httpsclient_id) or dynamic registration (RFC 7591). Access tokens (chitay_oat_…`) last an hour; refresh tokens rotate. A connection appears in the teacher's token list and is revoked there like a token.
- Every tool in
tools/listnow hasannotations(readOnlyHint,destructiveHint,idempotentHint,openWorldHint) andsecuritySchemes(the OAuth scope it needs). Destructive:tutor_delete_block,tutor_archive_lesson,tutor_remove_lesson_from_course,tutor_update_block. scope_missingfor an OAuth connection carries_meta["mcp/www_authenticate"], so the client can offer to sign in again with the missing scope.tutor_generate_lesson: three optional fields.courseIdwrites the lesson for that course — the course's title, level, audience, outcomes, outline and what the previous lessons taught go into the brief — and adds it to the course atposition(default last);subjectandleveldefault to the course's, sosubjectis no longer required.generateExercises: truecontinues past the material step: the model plans the lesson and the exercises are generated, with no extra quota. The result hascoursewhencourseIdwas given.tutor_get_generation_statusreports such a lesson asgeneratinguntil it is done.
1.0.0-beta.5 — 2026-10-01
Descriptions and rules take formatted text.
- The course
descriptionintutor_create_courseandtutor_update_courseis formatted text:**bold**,*italic*,~~strike~~, blank-line paragraphs,-and1.lists,>quote. Up to 2,000 visible characters (markers not counted);maxLengthis now 4,000, the stored ceiling. - The lesson
descriptionintutor_create_lesson,tutor_generate_lessonandtutor_update_lessonkeeps**bold**,*italic*,~~strike~~and paragraphs; list and quote lines are kept as typed. Up to 500 visible characters;maxLengthis now 1,000. forWhomandoutcomesitems also keep~~strike~~.tutor_get_block_schemafortheoryreturnsformatting: the rule's paragraphs may use the same formatting.- Over a visible limit, the tools answer
validation_failedwith the field's path (description;lesson.descriptionintutor_create_lesson). tutor_get_courseandtutor_get_lessonreturn the text as stored, markers included. The docs have a new section, «Форматований текст».
1.0.0-beta.4 — 2026-10-01
Courses say who they are for and what a learner gets.
tutor_create_courseandtutor_update_courseaccept two optional lists,forWhom(«Для кого цей курс») andoutcomes(«Що ви отримаєте після курсу»), shown on the course's storefront page and to its students. Up to 8 items of up to 200 visible characters each; only**bold**and*italic*are kept, other formatting is removed. A list is replaced whole;nullor[]clears it.- Over a limit, both answer
validation_failedwith the pathforWhom/outcomes(too many items) orforWhom[i]/outcomes[i](an item too long). tutor_get_coursereturnsforWhomandoutcomes, always arrays.
1.0.0-beta.3 — 2026-10-01
Lessons in use stay editable; courses carry a pacing.
- Breaking (pre-release): the error code
edit_lockedis gone. Every lesson tool now changes a lesson whatever students have done on it; answers, scores and feedback already handed in are kept.tutor_get_lessonstill returnseditable, alwaystrue. tutor_create_courseandtutor_update_courseacceptpacing:teacher_paced(the default) orself_paced, where a student opens each next lesson themselves. Pacing cannot change once the course has been assigned;tutor_update_coursethen answers the new error codeconflict.tutor_get_coursereturnspacingandpacingLocked.
1.0.0-beta.2 — 2026-09-30
Five tools, from what a nine-lesson course build missed. 20 tools now.
tutor_update_lesson— change a lesson's title, description, subject, level or instruction language (edit_lockedonce students work on it).tutor_archive_lesson— take a lesson out of the library. It is archived, not destroyed; the teacher restores it in the web app.tutor_get_course— a course with its lessons in order, each with thestepIdthe two tools below take.tutor_remove_lesson_from_courseandtutor_reorder_course_lessons— undo an add and set the order of a course's lessons.- Fix:
tutor_list_lessonsandtutor_get_lessonreported a lesson written by hand asplanned; they now saycompleted, astutor_get_generation_statusalready did. - A call whose arguments were sent inside a
raw,inputorargumentswrapper now gets an error that says so.
1.0.0-beta.1 — 2026-09-30
First release. Personal access tokens (read, write, publish scopes) and the tutor toolset, 15 tools. A beta may still change any of them; changes are listed here.
tutor_list_lessons,tutor_get_lesson,tutor_get_block_schema,tutor_list_courses,tutor_get_generation_status— read.tutor_create_lesson,tutor_add_block,tutor_update_block,tutor_delete_block,tutor_reorder_blocks— write a lesson by hand; the first is all-or-nothing and every problem comes back with its path.tutor_generate_lesson— start the platform's own generation from a topic, an article, a YouTube link or a transcript. It stops at the plan step, which the teacher confirms in the web app; the status tool reportspendingthere.tutor_create_course,tutor_update_course,tutor_add_lesson_to_course— courses.tutor_publish— publish or unpublish a course; needs thepublishscope and a teacher account allowed to publish.subjectandleveloftutor_create_lessonandtutor_generate_lessonare now enums (the same lists the web form and the courses tools use); the reference lists the allowed values with their names./llms.txtand/mcp/docs.md?tool=<name>serve the docs one tool at a time.
