Commit Graph
743 Commits
Author SHA1 Message Date
wyuc a8c745a791 feat(generation): self-host interactive scene libraries with robust CDN URL mapping (#1972)
Interactive scenes load KaTeX, Three.js (with addons), Chart.js and the Tailwind v4 browser runtime from the deployment (/vendor/interactive, configurable via the build-time INTERACTIVE_ASSET_BASE_URL) instead of public CDNs. KaTeX is injected only into pages with detectable math, synchronously at the start of head (same-origin and immutable-cached), with the #1966 fallback when the asset fails; reprocessing refreshes platform-injected KaTeX tags against the current asset base. A parser-based mapper rewrites compatible public CDN URLs for these libraries to the hosted copies, drops integrity, leaves unknown URLs untouched and is idempotent; stored scenes are reprocessed on open and before export, and exports fetch hosted assets directly. Legacy Tailwind v3 Play CDN is not mapped. @openmaic/generation 0.3.24. Closes #1971.
@openmaic/generation@0.3.24
2026-10-21 22:46:51 +08:00
杨慎 b87e014423 fix(renderer): fit short Cartesian charts and preserve readable labels (#1973)
* fix(renderer): fit short Cartesian charts (#1968)

ECharts default grid margins consume 145px and collapse short charts. Use relative margins with label containment and a scrollable legend in the app and SDK, leave room above line labels, and preserve explicit imported plot rectangles. Register ECharts 6 containment compatibility and cover real SVG layout, text bounds, and resize behavior.

* fix(renderer): keep compact chart endpoint labels visible

* fix(deps): sync renderer ECharts peer constraint in lockfile

* fix(renderer): size chart text and legend margins in pixels

Percentage text margins over-reserved space on normal-size charts: an 800x450 two-series line plot shrank from the 305px main baseline to 214px. Use 22px label headroom and a 26px legend row, and verify normal-size plot height and resizing in both builders.
@openmaic/renderer@0.2.0
2026-10-21 18:48:25 +08:00
杨慎 120acf5653 test(agent-runtime): isolate parallel PostgreSQL contracts (#1955)
Give the prior-run and park-attempt PostgreSQL contract suites separate schemas and drop leftover schemas before setup, so parallel suites no longer truncate each other's tables and deadlock. Test-only change. Closes #1954.
2026-10-21 17:54:21 +08:00
杨慎 33b6cae669 fix(dev): disable automatic agent rule files (#1928) 2026-10-21 17:25:09 +08:00
xuyuanwei678 63f17991c3 feat(tts): configure provider-local voice lists and defaults in YAML (#1969)
TTS provider presets in YAML can now declare a provider-local voice list and options.defaultVoice. Config validation rejects voices on non-TTS presets and defaultVoice values outside the configured list; cloned voices are preserved. Documented in all doc locales.
2026-10-21 15:16:50 +08:00
Yizuki_AmeandYizukiAme d111c4b04d fix(renderer): hide pending inline math sources (#1962)
Formulas deferred by the rendering budget stay hidden until they are typeset, so raw LaTeX no longer flashes on dense slides; sources that cannot be typeset are still shown as text. Budgets and scheduling are unchanged. Bumps @openmaic/renderer to 0.1.17.

Related to #1869

Co-authored-by: YizukiAme <YizukiAme@users.noreply.github.com>
@openmaic/renderer@0.1.17
2026-10-21 11:51:55 +08:00
LING DUAN c4a24031b8 feat: integrate material library into main (#1896)
Adds the owner-scoped material library ("Knowledge base" in the UI) from the integration branch, as tracked in #1736 (RFC: Discussion #1716).

- Library page from the left rail: one folder-and-file list with search, automatic parsing after upload, Parse again, in-place folder creation and renaming, drag-to-move, source and folder deletion with confirmation, usage and separately counted file storage.
- Composer `@` and toolbar picker over the whole library; failed materials cannot be attached from any entry point.
- Agent tools to list, organize and parse materials, with one-line summaries in tool rows; deletion stays page-only.
- Originals and extraction outputs live in the asset pool under generic `asset_root_refs`; extraction is reused across conversations.
- Every successful upload, from classic and Pro and including existing undeleted uploads, stays in the library until explicitly deleted (#1898). The 24-hour sweep only reclaims unfinished upload reservations.
- `@openmaic/storage` 0.38.0.

Release conditions (breaking): stop all old instances before this version accepts writes, do not roll back below this release, and enable `MATERIALS_POOL_BACKFILL=1` only after every old instance has stopped. See CHANGELOG for schema additions and `ASSET_COLLECTION_GRACE_MS`.
@openmaic/storage@0.38.0
2026-10-21 11:50:06 +08:00
wyuc 99e87f4e42 fix(generation): inject KaTeX into interactive scenes that reference it (#1966)
Inject the platform's KaTeX at the start of <head>, ahead of page scripts, guarded by a data-openmaic-katex marker instead of the word "katex", with no-op stand-ins when the CDN is unreachable, so pages that ship their own KaTeX no longer crash with a ReferenceError and init()-filled labels typeset on first paint. Adds an interactive-math prompt snippet and bumps @openmaic/generation to 0.3.23.

Fixes #1538
@openmaic/generation@0.3.23
2026-10-21 10:44:31 +08:00
杨慎andcosarah 6e20534fe0 fix(svg): validate malformed slide shapes and recover their text (#1915)
Add @openmaic/geometry, a browser-independent validator for SVG path syntax, finite view boxes and transforms and bounded resources, with structured errors and shared shape-to-text recovery. Generation, rendering, both editors and PPTX export use it: invalid shapes with a label render as text, unlabelled ones are omitted, stored records are not rewritten, and recovered shapes cannot be resized. Imported PPTX labels keep their own insets. Bumps generation 0.3.22, renderer 0.1.16, editor 0.0.12 and geometry 0.1.0.

Closes #1851

Co-authored-by: cosarah <cosarah@users.noreply.github.com>
@openmaic/geometry@0.1.0 @openmaic/renderer@0.1.16 @openmaic/editor@0.0.12 @openmaic/generation@0.3.22
2026-10-20 11:53:54 +08:00
Yizuki_AmeandYizukiAme 86f38c3181 fix(renderer): bound inline math work without starving active slides (#1930)
Share a per-frame markup allowance (256k characters) across live prose roots, let thumbnails use only what the foreground leaves and finish in idle time, reuse deferred typesetting results, and keep snapshot rendering synchronous. Matrix-heavy slides no longer block the main thread in one long task; ordinary and dense slides still typeset before paint. Bumps @openmaic/renderer to 0.1.15.

Fixes #1869

Co-authored-by: YizukiAme <YizukiAme@users.noreply.github.com>
@openmaic/renderer@0.1.15
2026-10-20 11:08:48 +08:00
OliveryfasoandOliveryfaso aaca61742c feat(editor): derive current course issues and thumbnail markers (#1903)
Phase 1 of Course issues (#1900): a pure collectCourseIssues in @openmaic/dsl 0.12.0 derives issues from the current course document (speech without audio, generated-media placeholders, dangling cues, action-content lint) with stable ids and structured evidence, and the editor thumbnails show warning markers that clear when the issue is fixed. Narration issues are skipped when the workspace cannot generate audio.

Related to #1900

Co-authored-by: Oliveryfaso <Oliveryfaso@users.noreply.github.com>
@openmaic/dsl@0.12.0
2026-10-19 16:21:41 +08:00
jackandFrank-zhu2000 9c872bdde3 fix(agents): match generated agent voices to catalogue gender (#1908)
Pass catalogue voice gender to the agent-profile prompt, ask the model to keep voice, name and persona gender consistent, persist a language-independent voiceDesign.gender, and make the fallback voice pick prefer the agent's gender. Catalogues without male/female data keep the previous behavior.

Closes #1084

Co-authored-by: Frank-zhu2000 <Frank-zhu2000@users.noreply.github.com>
@openmaic/dsl@0.11.4
2026-10-19 15:36:45 +08:00
wyucandClaude Opus 5.5 729c044b5b chore(models): remove the retired Veo 3.1 preview models (#1948)
Google shuts down veo-3.1-generate-preview, veo-3.1-fast-generate-preview
and veo-3.1-lite-generate-preview on 2026-10-22. They were the last models
of the built-in Veo video provider (Veo 3.0 and 2.0 went in #1939), and the
Veo adapter does not speak the API of Google's replacement,
gemini-omni-1.1-flash. A catalog entry that cannot generate is worse than
an absent one, so the provider is removed as Sora was: its catalog entry,
type-union member, adapter, UI name and icon, VIDEO_VEO_* mapping, docs rows
and tests. OpenRouter Video keeps google/veo-3.1, which OpenRouter serves
from Vertex AI and is not part of this shutdown.

Configurations written for earlier versions keep working. RETIRED_PRESETS
names the removed preset: an openmaic.yml provider with preset: veo no
longer stops the server, the slots that named such a provider (in the file
or in workspace settings) follow their parents again, and startup notices
ask to remove the provider and any VIDEO_VEO_* variables. Referencing the
provider directly fails with the reason instead of "unknown preset".

Supporting gemini-omni-1.1-flash is tracked in #1940.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 12:48:48 +08:00
6b177f7abb feat(generation): show page currently being generated on course cards (#1856) (#1926)
* feat(generation): show page currently being generated on course cards (#1856)

* fix(generation): derive current page from active step in course cards

---------

Co-authored-by: cham <2577781125@qq.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-19 11:19:32 +08:00
6b83751a87 fix: restore export after switching classrooms (#1934)
* fix: reset failed outlines when loading a classroom

* chore(store): write the failedOutlines comment in English

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 22:09:42 +08:00
AbelWangYaBoandwyuc 0be015bbb8 fix(media): bound provider media downloads in the video adapters (#1933)
Three adapters read a provider-returned file with a bare
`response.arrayBuffer()` before inlining it as a data URL — the Veo and
OpenRouter video downloads, and the ComfyUI `/view` image: a declared
length past any sane size was still buffered in full, and a body without
one (or longer than declared) was read without bound. #1688 bounded the
MinerU Cloud reads and #1692 bounded the classroom media downloads; this
applies the same shape to the adapters' own downloads.

Move `bounded-download.ts` from `lib/server` to `lib/media` so the
adapters can share the one mechanism (they run on both the browser and
the server and, per the convention kept in #1695, import no
`@/lib/server` code). The old path re-exports, so server callers are
unchanged. `readResponseBodyWithLimit` gains an optional `label` that
names the refused download in the error; without it, messages are
byte-identical to before. `Buffer.concat` now takes the chunks directly.
New `MAX_PROVIDER_MEDIA_BYTES` (200 MB) aligns with the agent runtime's
`MAX_GENERATED_VIDEO_BYTES`, so a clip the persist path accepts is never
refused one step earlier at the download.

The Veo, OpenRouter-video and ComfyUI call sites swap `arrayBuffer()`
for the bounded read at their single download choke point — after the
redirect handling, so the `redirect: 'manual'` + `assertNotRedirected`
guards (#1636) and the injected-transport paths (#1695) are untouched.

Tests cover the fast reject, a stream that lies about or omits its
length (and is cancelled on refusal), the unlabeled message shape
existing callers assert, and one case per adapter driven through the
public generate entry with an oversized declared download. Reverting any
of the three call sites turns its adapter case red.

AI-assisted commit

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-18 21:57:32 +08:00
wyucandClaude Opus 5.5 73c81dc558 docs(readme): add v1.2.1 to News (#1946)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 21:24:12 +08:00
wyucandClaude Opus 5.5 e19d0d4f45 release: v1.2.1 (#1944)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
v1.2.1
2026-10-18 21:19:55 +08:00
wyucandClaude Opus 5.5 f7d056e376 fix(roundtable): smooth the suggested-reply bubble entrance (#1943)
The suggested-reply bubble and the chat bubble lived in two separate
AnimatePresence groups inside a vertically centered flex column. When
cue_user cleared the bubble role, the outgoing teacher/agent bubble kept
its layout space for its 0.12s exit while the suggested-reply bubble
mounted next to it, so the new bubble appeared off-center and then
jumped when the old one unmounted.

Render both in one AnimatePresence with mode="wait" (they are mutually
exclusive), so the next bubble only mounts after the previous exit has
finished and the column never holds two bubbles at once.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 21:07:03 +08:00
+13 dc88fb5011 feat(web-search): add Firecrawl provider (#1834)
* feat(web-search): add Firecrawl provider

* fix(generation): require explicit state publication and initialize game state (#1795)

* fix(generation): require explicit state publication and initialization

* fix(generation): bump package version to 0.3.16

* test(generation): stop old worker before seeding recovery checkpoint

* refactor: deduplicate export menu items (#1693)

Co-authored-by: Tiyatrotist <179411334+Tiyatrotist@users.noreply.github.com>

* fix(server): client TTS URL refusal must not promise ALLOW_LOCAL_NETWORKS (#1798)

* fix(server): client TTS URL refusal must not promise ALLOW_LOCAL_NETWORKS

validatePublicUrlForSSRF now passes clientSupplied: true.
Opt-in-governed refusals on that call — loopback, localhost, .local,
private, link-local, and CGNAT literals, and a DNS answer set whose
disqualifying addresses are all in those ranges — use a new string
stating that ALLOW_LOCAL_NETWORKS does not apply and that the endpoint
must be an operator-managed provider in server-providers.yml.
validateUrlForSSRF still returns the existing flag guidance when the
flag is unset and still allows those targets when it is set.
Cloud-metadata targets keep their own message, and reserved, multicast,
and broadcast addresses, including a DNS answer set that contains one,
keep the generic local-network message.

Fixes #1771

* fix(server): point client TTS URL refusal at openmaic.yml

1.2.0 deprecates server-providers.yml; operator-managed provider
endpoints now live in openmaic.yml under providers:.

---------

Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(render): isolate preview execution from video exports (#1830)

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(test): normalize Windows path separators and replace shell grep in test suite (#1642) (#1828)

* test: normalize Windows path separators and replace shell grep in test suite (#1642)

* ci: re-trigger checks

---------

Co-authored-by: cham <2577781125@qq.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(export): drop non-woff2 font fallbacks instead of about:invalid (#1826)

* fix(export): drop non-woff2 font fallbacks instead of about:invalid

When an inlined stylesheet's @font-face offers a woff2, the inliner kept
only the woff2 and pointed the woff/ttf/otf/eot fallbacks at
url(about:invalid). Chromium and WebKit check every @font-face src URL
against the page's font-src CSP when the rule is parsed, whether or not
the face is ever used, so the standalone HTML export (font-src data:)
logged one CSP violation per fallback: about 40 for a page that loads the
KaTeX stylesheet. The woff2 fonts were inlined and render; the errors
were noise.

Remove those fallback entries from the src list instead, keeping local()
entries and format() hints, and remove a src declaration left empty.
@font-face rules without a woff2 are inlined as before, and a woff2 that
fails to fetch is still reported through the inline failure report.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): prune font fallbacks per src declaration

The woff2 check ran across the whole @font-face rule, so a later src
declaration without a woff2 (src:url(A.woff2);src:url(B.ttf)) was
removed and the earlier woff2 won the cascade instead of the authored
B.ttf. Judge each src declaration on its own: only a declaration that
offers a woff2 loses its woff/ttf/otf/eot entries, and declarations are
never removed.

Also treat an entry with a format("woff2") hint as woff2, so an
extensionless or mis-named woff2 URL counts and is never pruned.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): keep font fallbacks behind conditional woff2 sources

Only prune woff/ttf/otf/eot fallbacks that follow an unconditional woff2
source in the same src list: a single url() with a plain format("woff2")
or format(woff2) hint (or none, with a woff2 URL). A woff2 entry gated by
tech(), `supports` inside format(), a woff2-variations or multi-format
hint is skipped by browsers that lack the feature (WebKit does not support
tech(color-COLRv1)), so the fallbacks behind it are kept and inlined.
Entries before the first unconditional woff2 are kept as well, since a
browser would use them first.

Fallbacks after an unconditional woff2 are now also recognised by their
format() hint, so extensionless TTF/WOFF URLs are pruned too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): treat malformed woff2 format() hints as conditional

parseFontSrcEntry skipped separator tokens inside format(), so the
malformed `format("woff2",)` read as a plain woff2 hint and the fallbacks
behind it were pruned. Browsers skip such an entry, which left the face
with no usable source and no reported asset failure.

format() now keeps every token (separators as themselves, nested
functions and unclosed strings as empty tokens), and an unclosed url() or
format() counts as an extra part, so only an exact single `woff2`
keyword or string qualifies as unconditional. Anything else keeps and
inlines the fallbacks.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(math): disable formula-defined macros in KaTeX and Temml rendering (#1827)

* fix(math): disable formula-defined macros in every KaTeX and Temml render

Add safeKatexOptions to @openmaic/dsl, the one package every renderer,
importer, editor and the app already depend on. It merges hardened
settings into each caller's options: macro-defining commands (\def,
\gdef, \edef, \xdef, \global, \long, \let, \futurelet, \newcommand,
\renewcommand, \providecommand) become inert macros that consume the
definition, trust is forced off, maxExpand is pinned, and a fresh
macros object is built per call so nothing persists between renders.
Caller options and caller-supplied macros are kept.

Route every render through it: whiteboard and slide latex elements,
quiz math, standalone HTML inline math, PPTX export via Temml, the
editor's latex dialog and inline math node, generated latex elements,
and the importer's formula paths. Keep the importer's node-globals
rollup plugin off the dsl build, whose old parser cannot read `??`.

Tests cover each render path with nested-definition inputs, a corpus of
legitimate formulas that must render byte-identically, \gdef isolation,
and a guard that fails if a new KaTeX/Temml call skips the helper.

Bump @openmaic/dsl 0.11.3, editor 0.0.10, generation 0.3.16,
importer 0.3.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(math): harden workbench chat math and newcommand parsing

Workbench chat Markdown rendered math through @streamdown/math, which
only forwards errorColor to rehype-katex. Add createSafeMathPlugin,
which keeps that plugin's remark side and rehype-katex instance but
replaces the rehype options with safeKatexOptions, and use it in the
chat text block.

Rework the inert \newcommand family: peek at unconsumed tokens so a
body written as {[} stays a body, accept the starred form, skip [n]
and [default] groups with brace-aware scanning, then consume exactly
one replacement body. Document that caller-supplied macros are trusted
code and must not be derived from content.

Replace the call-text coverage check with an import-aware guard built
on the TypeScript parser. It finds every runtime import of a math
engine (default, aliased, named, namespace, side-effect, import =
require, re-export, dynamic import, require) plus injected auto-render
script text, and requires each file to be on a reviewed allowlist.
Files that import KaTeX or Temml directly must use them only as render
calls with safeKatexOptions(...). The interactive post-processor is
allowlisted: its page already runs model-written scripts in a sandboxed
iframe. Fixtures cover each bypass shape.

Add KaTeX and Temml regression tests for the newcommand edge cases,
and the workbench chat path to the expansion-input suite.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(math): fresh macros per chat formula and stricter render guard

KaTeX writes built-in state into the macros object while rendering (an
align environment sets \@eqnsw), and rehype-katex spreads one options
object into every render. The workbench chat plugin shared one macros
object, so that state leaked between formulas and between messages.
Make macros an enumerable getter that returns a fresh hardened object
on every read, so each render and each error retry gets its own. Add
cross-formula and cross-message regression tests.

Tighten the guard for files that import KaTeX or Temml directly: any
engine reach other than a static default or namespace import (require,
dynamic import, re-export, import = require, side-effect import) is
rejected; the options argument is checked at each method's own
position with nothing after it; and it must be a call to
safeKatexOptions imported from @openmaic/dsl, not a local look-alike.
Document the guard's scope: module imports only; global access, engine
code inside other HTML strings and require.resolve need review.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(math): keep built-in equation numbering with macro definitions disabled

KaTeX and Temml implement \tag, \tag*, \nonumber and \notag as built-in
macros that expand to \gdef\df@tag{\text{...}} and \gdef\@eqnsw{0}.
Swallowing every \gdef therefore dropped equation tags and stopped
\nonumber / \notag from suppressing align/gather/equation numbers.

The inert \gdef now accepts exactly those two built-in shapes and stores
them the way the engines' own \gdef does; every other \gdef, and every
other definition command, stays inert. '@' is a letter in both lexers,
so formulas can name these macros directly; the allowed shapes add
nothing \tag* and \nonumber do not already provide:

- \@eqnsw may only be set to 0;
- \df@tag may only be one \text{...} group that never mentions \df@tag,
  so the tag is expanded exactly once (a self-reference would recurse
  until the call stack or the expansion budget runs out, as it does in
  the stock engines on \tag{\df@tag}).

Tests: tagged and \notag/\nonumber formulas render identically to stock
KaTeX (html, mathml, htmlAndMathml) and Temml; the slide element, quiz,
editor dialog and Workbench chat renderers show tags and suppress
numbers; definitions inside tags, self-referencing tags, nested tags and
non-built-in \df@tag/\@eqnsw shapes stay inert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(math): expand a tag in full only once per accepted definition

A formula can name \df@tag itself, so a long \tag*{...} (or an accepted
\gdef\df@tag{\text{...}}) followed by many \df@tag mentions re-expanded
the whole tag on every mention, up to the expansion budget: about 12 KB
of input produced several MB of output.

An accepted \df@tag is now stored as a macro that yields its body on the
first expansion and an empty \text{} afterwards. The engines expand
\df@tag once per formula, or once per align row before clearing it, so
tags render unchanged (stock-equality tests, including an align with a
tag on several rows, stay green in KaTeX and Temml). The empty \text{}
rather than nothing avoids a Temml TypeError on an empty tag.

Also document, and test through the PPTX export, that Temml throws a
TypeError on a script left bare by an inert definition (x^\notag); the
only Temml consumer catches it and returns null.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(generation): bump to 0.3.17 after main took 0.3.16

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(export): play the standalone HTML classroom with narration, effects and video (#1842)

* feat(export): keep playback actions and embed narration in standalone HTML

The standalone HTML manifest now keeps each scene's playback actions,
reduced to what an offline player can replay: speech text (plus its
audioRef when the bytes ship), spotlight/laser targets, play_video,
widget actions, and the discussion topic. Whiteboard actions, unknown
types, discussion prompts and agent bindings are left out.

With the new includeNarration option the snapshot collects narration
(stored and legacy audioUrl) and video bytes. Actions and video elements
name them by archive path, and the bytes travel as base64 data blocks
(script type="application/octet-stream") indexed by a media table, so
the browser keeps them as text until a clip plays. Payload collection is
format-neutral so a later folder variant can ship the same paths as
files. The export reports its byte size and missing narration; the CSP
is unchanged and the file still makes no network requests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(standalone-player): play the classroom with narration, effects and captions

A lightweight sequencer replays each scene's actions the way the
classroom's playback engine does, without its stores or IndexedDB audio
player (only the pure timing helpers are shared):

- speech waits for its embedded narration, or for the classroom's
  reading-time estimate when there is none; its text is shown as a
  caption that can be toggled;
- spotlight and laser drive SlideCanvas effects, fire without blocking
  so they overlap the next speech, clear 5 s after the latest one and
  on every scene change;
- play_video plays the embedded clip in place and waits for its end
  (capped); a video without bytes keeps its poster;
- discussion shows a card with the topic and a link to the online
  classroom, closing on its own after a few seconds;
- widget actions are posted to the sandboxed interactive iframe;
- whiteboard and unknown actions are skipped.

Playback starts only from the Play button (or Space), which primes the
shared narration element inside the gesture; a refused play() falls back
to the reading timer, and video to muted playback. Slide scenes advance
automatically; quiz, interactive and PBL scenes hold after their
narration, as the classroom's auto-play does, until the learner
continues. Navigating cancels the running scene cleanly and, while
playing, starts the new scene from its beginning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(export): choose narration in the HTML export menu and warn on large files

"Export as HTML" becomes a submenu, like the PPTX one: "With narration
and video" embeds narration audio and video clips, "Without narration"
keeps the file small (captions on the reading timer, poster frames for
videos). The option that fits the classroom is listed first. Narration
that could not be embedded counts as a partial export, and files above
100 MB get a size warning.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): label narration by the container its bytes are

Stored narration can carry the wrong format: a provider that answers
WAV without a usable Content-Type is recorded as mp3. Exports then
labelled the clip audio/mpeg and named it .mp3, and WebKit, trusting
the label, reported a WAV with a streaming placeholder data length as
about 44,700 s long.

The narration collectors shared by the classroom ZIP and the standalone
HTML export now sniff the container from the leading bytes (RIFF/WAVE,
ID3 or MPEG frame sync, OggS, fLaC, ftyp, WebM) and use it for the MIME
type and archive extension; unrecognized bytes keep the stored label.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): tighten standalone media policy and build large files as Blob parts

- A slide video whose src is a direct URL no stored asset backs is now
  fetched (same timeout policy as images) and embedded; when it cannot
  be fetched it is reported as unresolved media instead of silently
  falling back to its poster.
- "Without narration" now means no audio or video payload anywhere:
  interactive pages do not fetch their <video>/<audio> sources (new
  skipMedia inline option) and already-embedded clips are stripped,
  while their images, posters and other assets are still inlined.
- Slide audio elements, which the offline player never plays, are no
  longer collected or counted as missing narration.
- The document is assembled as Blob parts (base64 in pieces, clips
  encoded one at a time), so no single string approaches V8's length
  limit. The size is estimated from the media byte counts before
  anything is encoded; above 400 MB the export stops with a localized
  explanation (StandaloneHtmlTooLargeError, the hook for a future
  page-plus-media-folder fallback). The 100 MB warning stays.
- Media block comments now say when a block is decoded.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(standalone-player): stop videos at their cap and keep controls in step

- play_video now pauses the clip when its wait cap passes or the run is
  cancelled, and clears the losing timer and listeners when the wait
  settles, so a clip never plays on under the next narration.
- The video's own controls stay in step with playback: pausing the
  awaited clip pauses playback and playing it resumes; starting any
  other video pauses the narration, and resuming playback pauses that
  video again.
- Space leaves a focused video or audio element to toggle itself, and
  keeps scrolling quiz and PBL scenes when focus is inside the scene.
- A caption lasts as long as its speech, so nothing is left over a
  held quiz or interactive scene.
- Play after the last scene finished starts over from the first scene.
- The start overlay shows on whichever scene the file opens on and goes
  away on any navigation, a hash change included.
- Body text is antialiased like the classroom page.
- Tests for the media ports (pause racing play, refused and failing
  clips, muted retry, cap, control sync, widget queue), the media
  library, the overlay and Space rules, and holding for every held
  scene type.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): exact size ceiling, thorough media stripping, ADTS behind ID3

- Resuming the awaited video through its own controls now pauses any
  video started by hand, as resuming playback by any other path does.
- The size estimate counts the manifest as the escaped UTF-8 bytes the
  document carries, and the assembled Blob is checked against the
  ceiling too, so the 400 MB guard holds exactly (maxBytes is an option
  for hosts and tests).
- Without narration, the src of <video>, <audio> and their <source>
  elements is stripped for any data: URI whatever MIME it declares, and
  stripping recurses into nested srcdoc documents (bounded depth; deeper
  documents are dropped).
- Audio sniffing skips a leading ID3v2 tag (syncsafe size) and reads
  the frame after it: MPEG audio stays mp3, AAC ADTS becomes aac, also
  for untagged ADTS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(standalone-player): toggle a focused video on Space in every browser

WebKit's native video controls ignore Space, so with the slide video
focused nothing happened while the video kept playing. The player now
handles Space on a focused video or audio element itself, in the
capture phase, toggling that element and stopping the press so
Chromium's native toggle does not fire as well; the element's play and
pause events keep playback in step exactly as its controls do.
Verified in Chromium, WebKit and Firefox.

The "Without narration" export description no longer promises a still
frame for videos (generated videos have none); it says videos are not
included, in all locales.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(export): fall back to a ZIP of classroom.html and its media for large classrooms (#1845)

* feat(export): add a stored ZIP writer that references its entries' Blobs

The standalone export's media-folder variant ships already-compressed
narration and video. JSZip reads every input Blob into an ArrayBuffer and
concatenates its output into one ArrayBuffer, so a multi-hundred-megabyte
archive would sit in the tab several times over. This writer stores entries
uncompressed, reads each one a slice at a time only to compute its CRC-32,
and returns a Blob composed of the entries' own Blobs, so no media is
copied. Paths are checked to stay inside the extraction folder, and
archives plain ZIP cannot describe (4 GiB) are refused.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(standalone-player): say so when media shipped next to the page is missing

A page whose media table names files by relative path (the ZIP variant of
the export) plays nothing when opened without them: straight from inside
the ZIP, or copied out alone. The media library now probes one linked file
as the player opens and records any linked clip that fails to load, and the
player shows a notice asking to extract the whole ZIP. Playback carries on
as before: failed narration falls back to the reading timer and a failed
video no longer holds the sequence.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* feat(export): fall back to a ZIP of classroom.html and its media folders

A classroom whose single HTML file would pass the 400 MB ceiling is now
exported as a ZIP instead of refused: classroom.html carries the player and
manifest, and its media table names each narration and video file by
relative path (audio/..., media/...) next to it, plus a README in the UI
locale and English. The ZIP needs no base64 and copies no media, so it is
built from the same snapshot without a second collection pass.

The page's CSP differs from the single file's only in media-src, which adds
'self' so <audio>/<video> elements may load the sibling files (Chromium and
WebKit match it against file: URLs when the page is opened from disk);
connect-src stays 'none', so the player never reads the bytes itself. The
single file is unchanged, byte for byte.

The fallback is automatic, at the same ceiling, because one file is the
better format wherever it works; the export menu keeps its two entries.
A toast explains why a ZIP was saved and that it must be extracted before
opening classroom.html.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): keep stored ZIP fields below the ZIP64 sentinels

0xFFFF entries and 32-bit sizes or offsets of 0xFFFFFFFF announce ZIP64
records, so a plain archive must stay below them: the writer now refuses
65,535 entries and any size, offset or archive length that would reach
0xFFFFFFFF, and limits entry names by their UTF-8 bytes (what the header
field holds) instead of UTF-16 units. The CRC slice size is injectable.

Tests now read the raw bytes: every local header is compared field by
field with its central directory entry and the end record, and the CRC
carry across slices, the boundaries and the DOS date clamp are covered.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(standalone-player): report every linked file that fails, and word the notice for both causes

WebKit and Firefox reject play() with NotSupportedError for a narration
file that is not there, before (or without) an error event, and the clip's
handler was gone by the time the event fired: a missing clip after a
successful startup probe played silently with no notice. The rejection
now reports linked clips, and the narration element keeps a standing error
listener for the clip it is loading.

When the media table links no file (an export without narration), the
startup probe loads a linked slide image instead.

A file in a codec the browser cannot play fails exactly like a missing one
on file:, so the notice now covers both: "Some images, narration or video
couldn't be loaded. If you opened classroom.html from inside the ZIP,
extract the whole ZIP first." Adds a SlideScene test for video errors.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): ship slide images as files in the ZIP and refuse an oversized page

The ZIP fallback kept slide images, backgrounds, patterns, chart point
images and video posters inline as data: URIs, so a classroom heavy in
images could produce a ZIP whose classroom.html alone passed the ceiling.
In the ZIP they are now files under images/, named by relative path, and
the page's CSP adds 'self' to img-src as well as media-src. Image bytes
are collected once and encoded as data: URIs only for the single file; the
single file's size is estimated from the linked manifest, exactly, without
encoding anything. The single file is unchanged.

Media inside interactive scenes stays inline: those pages run in sandboxed
opaque-origin frames, which Chromium and Firefox do not let load files
from disk (WebKit does). A ZIP whose page alone still passes the ceiling
is refused with its own message (StandaloneHtmlTooLargeError of kind
"page"), and the fallback toast and README name what the ZIP holds.

The CSP comment now spells out what 'self' allows when the folder is
served over HTTP: same-host GETs, with cookies, from image and media
elements (interactive frames included); nothing can be read back, since
connect-src stays 'none'.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): keep chart point images inline and ship inline slide images as files in the ZIP

Two gaps in the ZIP variant's image handling:

- Pictorial charts rendered blank: the chart renderer wraps each point
  image in a data: SVG symbol, which cannot load a file, so a relative
  path there drew nothing in any browser. Chart point images now stay
  inline as data: URIs in the ZIP (a ref named only by a chart ships no
  file).
- Images that were already data: URIs (images, backgrounds, shape
  patterns, video posters) were never collected and stayed in the page,
  so such a classroom could still be refused as too large. In the ZIP
  they are now decoded into files under images/, one per distinct URI;
  a MIME type no file extension conveys, or a malformed URI, stays
  inline. The single-file estimate counts each one as the exact escaped
  URI it replaces, and the single file keeps them as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): follow-ups from the standalone HTML playback review (#1848)

* fix(export): pause a first hand-started video when a second starts; keep captions off narrow scenes

Starting a second video by hand on one slide left both playing. The
registry now pauses the other hand-started videos (never the one the
sequencer awaits).

On narrow viewports the caption bar covered part of the scene (quiz
options). It now has its own strip below the scene; from the sm
breakpoint up it overlays the scene as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): accurate export messages and menu order; static fallback without JavaScript

- Size warnings only suggest exporting without narration when narration
  was included.
- Missing narration clips get their own toast wording instead of being
  counted as external assets that could not be bundled.
- The HTML export submenu prefers 'with narration and video' when the
  classroom has narration audio or slide video.
- The file carries a static message for viewers that do not run scripts
  (iOS Files preview, scripts disabled or blocked). It sits right before
  the player script so it never paints while a large file parses, is
  removed when the player mounts, switches to a generic "couldn't start"
  message if the player fails, and has a <noscript> copy. Localized
  through the player strings; the CSP is unchanged.
- Caption strip: fixed height, only while playback is active, scrolls long
  lines, also used on short (landscape) screens.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): fallback message on the first screen; report failed linked images; skip ZIP-only decoding for single files

- The static fallback message sat below the empty full-height root, so it
  started below the first screen. The empty root is now hidden until the
  player mounts. The fallback is removed after the player's first commit
  (not right after render()), so a first-render error still shows the
  "couldn't start" message.
- The no-JavaScript hint no longer names a platform-specific sharing step.
- Slide images that fail to load from a linked relative path (a missing
  images folder) now trigger the linked-files notice, also when the audio
  and video probes load.
- Inline data: images are only decoded into files once the ZIP is going to
  be built (about 0.6 s and +100 MB for 100 MB of images otherwise); the
  single file and its size estimate are unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(storage): bound DocumentStore HTTP requests with a deadline (#1790)

* fix(storage): bound DocumentStore HTTP requests with a deadline

HttpDocumentStore issued every request without a deadline, so a request
whose peer never answers held its promise forever. The stage autosave
keeps at most one save in flight (startFlushRound's flushInFlight guard)
and starts the next one only once that promise settles, so a single
stalled save silently stranded every later save for the life of the page
— generation and the editor kept working from the in-memory store, and
the loss only surfaced on reload.

Bound the request round trip — sending the body and receiving the
response headers — with an AbortController deadline (requestTimeoutMs,
default 30s, <= 0 disables). A stalled request now rejects with
HttpDocumentStoreError(0, 'HTTP_REQUEST_TIMEOUT'), which the autosave's
existing backoff already retries. This mirrors the budget HttpAssetStore
applies via probeTimeoutMs / startBoundedOperation.

Reading the response body stays outside the bound: a large document on a
slow link is slow, not stalled.

Co-Authored-By: Claude Code <noreply@anthropic.com>

* docs(changelog): describe the request budget's fixed throughput and ceiling

The throughput and ceiling are module constants, not HttpDocumentStore
options; only requestTimeoutMs is configurable.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Code <noreply@anthropic.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(export): hide the no-JavaScript fallback as soon as the standalone player starts (#1850)

The static fallback message is now hidden synchronously when the player
script runs (kept in the DOM), so a slow parse of a very large file can no
longer reveal it before the first commit. A start failure (sync or async
render error) un-hides it with the "couldn't start" text; it is still
removed after the first successful commit. Scripts that never run leave it
visible as before.

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(generation): explain exhausted plan quotas (#1831)

* fix(generation): explain exhausted plan quotas

* test(generation): use nullable model metadata in quota fixture

* fix(generation): keep provider quota detection neutral and scene-scoped

Address the review of #1831:

- The shared classification no longer reads vendor codes. MiniMax TTS and
  web search translate base_resp 1008/2056 into ProviderQuotaExhaustedError
  (thrown, or as the cause of the rate-limit error an HTTP 429 keeps), and
  isUpstreamQuotaExhausted checks only that marker and the
  OpenAI-compatible wire codes.
- The built-in classification reports PROVIDER_QUOTA_EXHAUSTED, so a host
  that meters its own QUOTA_EXHAUSTED can tell the two apart, and a host's
  start refusal keeps the host's own message.
- The classroom passes the guidance only while the pending scene card is
  the scene the run paused at; a scene the run went on past keeps the
  generic failure text.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PyhoDKKJ3gVoPbvCT3T99K

* test(generation): cover quota guidance through the classroom hook

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* Preserve rotation for generated slide shapes (#1855)

* fix preserving generated shape rotation

* bump generation package version

* fix generation rotation check formatting

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(storage): support path-style S3 addressing (AI-assisted) (#1849)

Adds an opt-in `AWS_S3_FORCE_PATH_STYLE` (`true` or `1`) that sets the AWS SDK v3 `forcePathStyle` client option for the S3 asset byte store, so S3-compatible stores such as MinIO and Ceph can be addressed as `endpoint/bucket/key`. Unset keeps the existing Amazon S3 behaviour. Bumps `@openmaic/storage` to 0.37.3.

Fixes #1686

Co-authored-by: weinaike <13814354+weinaike@users.noreply.github.com>

* fix(render): bound preview capacity through launch cleanup (#1836)

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(sanitize): store inline math as LaTeX source and typeset it in the client (#1829)

* fix(sanitize): keep inline math through the scene-content sanitizer

The prose policy flattened the editor's inline formulas on every
persistence read and write: it dropped data-inline-math, the MathML
annotation, the layout SVG and KaTeX positioning, so saved formulas
rendered broken and their LaTeX source was lost.

Move the lift / sanitize / re-render approach from the standalone HTML
export into lib/sanitize/inline-math.ts and apply it in
sanitizeProseHtml, so the persistence boundary and the export share one
implementation. It parses with parse5, so it needs no DOM and runs on
the server and in the browser alike. Each formula is replaced by an
empty source span before sanitizing, and every surviving source span is
replaced afterwards by a fresh KaTeX render (trust: false); authored
markup never bypasses the policy. Prose without a formula skips the
parse and is sanitized byte-for-byte as before. Renders are cached by
source, and pathological markup falls back to the plain policy instead
of failing the read or write.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(sanitize): bound inline math rendering and detect encoded KaTeX classes

KaTeX markup is 100-150x the size of its source and is regenerated
synchronously on every persistence read and write, so one large formula
could block the event loop for seconds and pin hundreds of MB in the
render cache.

- Render a formula only if its source is at most 2000 characters, and
  within a per-call budget of 16000 source characters and 1000
  formulas. Anything else stays a source span showing its LaTeX as text,
  so nothing is lost and the editor still recovers it. Limits are counted
  in document order, never time, so repeated passes stay stable.
- Bound the render cache by markup size (1 MB) and never cache renders
  over 32 KB.
- Pre-check on `data-inline-math` or `annotation` instead of `katex`:
  element and attribute names cannot be written as character references,
  but a class value can, so an encoded `katex` class no longer skips the
  lift and loses its source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(sanitize): store inline math as source and typeset it in the client

Rendering formulas on the server made every persistence read and write
run KaTeX on authored input, which user macros and long sources can turn
into seconds of CPU per document. Store each inline formula as its LaTeX
source instead and let the clients that display slides typeset it.

- The prose sanitizer reduces each inline formula (span[data-inline-math],
  else span.katex with a TeX annotation, entity-encoded class included)
  to <span data-inline-math="SRC">SRC</span> and allows only that
  attribute. The source doubles as text for consumers that do not render
  math. A source over 2000 characters is kept as plain text. The pre-pass
  uses htmlparser2, the parser sanitize-html uses, so it is linear and
  sees the same element boundaries; prose without a formula marker is
  sanitized exactly as before. The server never runs KaTeX, and the
  parse5 lift, render cache and budgets are gone.
- @openmaic/renderer typesets span[data-inline-math] in text, shape and
  table prose after injection (renderInlineMath / useInlineMath), with
  trust disabled, macro definitions blocked and bounded expansion. It
  also re-renders older content that still carries KaTeX markup. The
  app's slide renderer components use the same hook. Bump the renderer
  to 0.1.12.
- The standalone HTML export ships source-only formulas, which the
  player's renderer typesets, and ships the math fonts when a slide has
  an inline formula.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(slide-renderer): keep cell markup intact when formatting table text

formatText turned every space in a table cell into &nbsp;, including
the spaces inside tags, which broke any cell markup with attributes. An
inline formula in a cell was shown as its raw source instead of being
typeset. Only format the text between tags.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(renderer): allow 1000 macro expansions when typesetting inline math

A cap of 50 expansions rejects realistic long formulas: built-in
commands such as \neq, \iff, \, and \dots each count, and a formula with
a few dozen of them needs over 100. Macro definitions are blocked, so
expansion stays linear in the source and 1000 is only a backstop. This
matches the shared safe KaTeX options.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(sanitize): replace self-closing inline formulas in SVG and MathML once

Inside SVG or MathML the parser honours `/>` and reports the close as
implied while still on the opening token, so the replacement ended
before the formula started and the original span stayed next to the
stored one; the next pass then stored it again. End a formula no earlier
than its opening tag. Adds SVG and MathML cases and fuzzes the pass for
idempotency and formula shape.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(renderer): keep inline math typeset across re-renders

React can rewrite `dangerouslySetInnerHTML` markup on a re-render even
when the HTML string is unchanged, which put the stored source spans
back after a move or resize while the effect, keyed on the HTML, did not
run again. Typeset after every commit instead: formulas already typeset
are skipped, and typeset formulas are cached by source and cloned, so a
re-render costs a query and, at most, cheap clones. Typesetting never
updates React state.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(renderer): budget inline math typesetting per prose root

One slide packed with large formulas could block the page for hundreds of
milliseconds on every mount. Typeset at most 4000 characters of uncached
source or 100 uncached formulas per pass over a prose root before paint,
and the rest in idle time, a chunk of the same size per idle period. The
next commit, an unmount or new content cancels pending idle work. Past
50 000 characters or 1000 formulas per root, formulas are shown as their
LaTeX text. Slide snapshots typeset everything before capture. Covers
identical-content re-renders and A, B, A, A content sequences in both
renderers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(renderer): keep inline math progress across commits and complete snapshots per root

- Give injected prose a stable dangerouslySetInnerHTML value per markup
  string (text, shape label and each table cell, in both renderers), so
  React leaves unchanged markup alone. Typeset formulas and pending idle
  progress then survive re-renders; formulas too large to cache are no
  longer typeset again on every commit. The every-commit pass stays as a
  safety net.
- Mark each prose root and complete snapshots root by root, so each text
  box keeps its own hard cap as on the live slide instead of sharing one
  slide-wide count.
- Apply the hard cap from document order on every pass, whatever earlier
  passes typeset, and let a formula shown as text by an earlier cap be
  typeset once it falls within its root's cap.
- Note that the render cache bound counts serialized characters.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(renderer): bump to 0.1.13 after rebase

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(renderer): typeset inline math through the shared safeKatexOptions

Replace the local stand-in options (inert macro-definition commands,
trust: false, maxExpand 1000) with safeKatexOptions from @openmaic/dsl,
keeping the inline-specific settings (displayMode: false, output: html,
throwOnError: false, strict: ignore). The shared helper's expansion budget
is the same 1000, and it also keeps the built-in \tag/\notag state and
makes \long inert.

The math engine guard now lists the renderer's inline-math module as a
render-calls site and drops the standalone HTML rich-text module, which no
longer renders KaTeX itself.

Tests: ordinary formulas typeset byte-for-byte as with the previous
options, and formula-defined macros stay inert within one formula and
across formulas in the same prose root.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(sanitize): keep over-long inline formulas as formulas; bound typesetting only

The 2000-character bound dropped the data-inline-math marker at save time,
so an over-long formula became plain text for good. The bound now applies
only where formulas are typeset: the slide renderer already shows an
over-long source as text, and the editor's inline_math node now does the same
instead of typesetting it, using the renderer's MAX_INLINE_MATH_SOURCE.
@openmaic/editor 0.0.11.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(sanitize): a 100 KB formula is kept as a formula in the node-environment suite

Follows the sanitizer change: the length bound applies to typesetting only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(media): add GLM (Zhipu CogView) image generation provider [AI-assisted] (#1832)

Co-authored-by: cham <2577781125@qq.com>

* fix(generation): stop retrying explicit provider quota refusals (#1861)

* fix(generation): stop retrying explicit provider quota refusals

* fix(generation): review follow-ups for provider quota refusals

- Leave a quota refusal the host classifies to the host, as documented for
  `classifyFailure`: the built-in rule (`isProviderQuotaRefusal`) applies only
  to refusals it does not answer for, at every retry site.
- Name an exhausted quota in the fallback log line, from the failure that
  fired the fallback rather than an earlier attempt's.
- Stop reporting a retry after the outline fallback returns empty output.
- Drop the PBL loop-fallback change: a provider failure with an HTTP status
  already skips the loop, and no LLM adapter throws the native quota marker.
  `@openmaic/generation` stays at 0.3.18.
- Document that an explicit quota refusal goes to the fallback at once
  (configuration, all six languages) and how it meets `classifyFailure`.
- Test a 403 quota refusal falling back, a quota refusal the host classifies
  as retryable, and the stream error shapes the classifier reads.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(generation): persist quota refusal regression coverage

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(persistence): share one AsyncLocalStorage across owner-bound stores (#1871)

* fix(persistence): share one AsyncLocalStorage across owner-bound stores

createOwnerBoundDocumentStore() built a new AsyncLocalStorage on every
call, and servers build a store per request. Every AsyncLocalStorage that
has run stays registered with async_hooks for the life of the process, so
each new promise paid a context propagation for every store ever created.
The cost grew linearly with requests served: under sustained load the main
thread saturated in async_hooks propagation and GC, and the event loop
stalled long enough for health checks to time out.

Carry the pending operation in one module-level AsyncLocalStorage instead.
Each store gets a small OperationScope; running an operation pushes a frame
that names its scope and links to the enclosing frame, and a store reads the
nearest frame of its own. This keeps the previous semantics: a store never
sees another store's operation, an operation of another store started inside
it does not hide the outer one, and the innermost of a store's own nested
operations wins.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(persistence): keep only each store's current operation in a context

A context's operation frame linked to every frame that was current when it
started, including other stores' and finished ones, so fire-and-forget work
that kept re-entering stores retained every earlier operation for as long as
its newest callback lived. Hold an immutable map of each store's current
operation instead: a context now keeps at most one operation per store,
exactly as a storage per store did.

Mark OperationScope as exported for tests only, and export the operation
type so the test can name it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore(persistence): note the snapshot size and restore the gc flag in tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(security): enforce model authorization for server-managed providers (#1879)

Providers configured with server credentials only send model ids the deployment authorizes (explicit model list plus default/fallback/slot references for the capability); anything else gets the same HTTP 403 before the provider is contacted. Covers chat, verification, media, speech, transcription, model-based search, generation, agent, PBL, quiz grading and workspace assignments. Breaking change: credentialed providers without a model list accept only their default/fallback models.

Co-authored-by: I3ob0 <huzi0404@163.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: note automated Codex PR review in CONTRIBUTING (#1882)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(media): stop serving legacy media of deleted courses (#1883)

The classroom media route now checks the course lifecycle before touching the filesystem: a tombstoned course gets the same 404 as a missing file, a lifecycle lookup failure fails closed, and live courses (including legacy media without a course row) are served as before. Successful responses use private, max-age=300, must-revalidate; 416 and errors use private, no-store.

Co-authored-by: duanjialing.777 <duanjialing.777@bytedance.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(render): bind render jobs to the requesting owner (#1884)

Each MP4 render job is bound to the immutable owner of the submitting request: the app proxy asserts the owner on submit, poll, cancel and download, and the render-service only finds jobs for that owner (foreign and unknown jobs get the same 404, with no cancellation or artifact lookup). Job operations live under a separate /owner-bound/render namespace, so an instance that predates owner binding answers 404 without running a job handler and mixed old/new pools fail closed; job responses must carry the owner-bound marker. Upgrade the render-service together with or before the app.

Co-authored-by: duanjialing.777 <duanjialing.777@bytedance.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* release: v1.2.0-rc.2 (#1885)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(workbench): refuse oversized material uploads before sending them (#1887)

* fix(workbench): refuse oversized material uploads before sending them

The workbench uploader posted every picked file to /api/materials and only
learned about the size cap from the server's 413. The route does refuse an
oversized declared content-length early, but a reverse proxy that buffers
request bodies (nginx's default) still makes the browser send the whole file
first, so a user picking a 200 MB file waits for the full upload before
being told it is too large. Without such a proxy, the early 413 tends to
surface as a generic network failure instead of the size message.

Read the caps the capabilities endpoint already advertises
(maxDocumentBytes / maxMediaBytes, derived from the upload route's own
limits) and refuse a file over its class cap before any bytes are sent,
with the existing "file too large (limit X)" copy. The caps stay
server-owned, so a deployment that raises them is not blocked by a browser
constant. Discovery is fetched once per page and shared; a failed, invalid
or slow (>5s) read fails open to the server's 413, and once a read has
timed out later uploads do not wait on it again until it answers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(workbench): leave unsupported types to the server's 415

The upload route rejects an unsupported MIME (415) before it applies a size
cap. Only precheck the size of supported types, so an oversized unsupported
file still gets the format error instead of being told to shrink.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(import): preserve committed document on lost response (AI-assisted) (#1864)

* fix(import): preserve committed document on lost response (AI-assisted)

A rejected save response can arrive after the server has committed the imported aggregate. Do not compensate by deleting the stage, because that turns an unknown write outcome into permanent data loss. Keep disposable local-cache cleanup and cover the response-loss path with a stateful regression test.

* fix(import): verify rejected document saves

Read the new document back when saveDocument rejects. Treat a found document as committed, while confirmed absence and read failures keep the import on the error path without destructive cleanup. Cover all three outcomes in the stateful import test.

* ci: cover every app PostgreSQL contract suite (#1867)

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(chat): guard Pi classroom tool calling before inference (#1894)

* fix(chat): guard Pi classroom tool calling before inference

* fix(i18n): match Pi model guidance to settings labels

* fix(renderer): cancel idle typesetting with its own pair and keep release-gate tests stable (#1901)

* fix(renderer): cancel idle typesetting with the pair that scheduled it

whenIdle checked requestIdleCallback/cancelIdleCallback when scheduling but
read cancelIdleCallback again when cancelling. If the global was removed or
replaced in between (a test stub restored, a polyfill swapped in), unmounting
a text element with pending inline math threw "scope.cancelIdleCallback is not
a function", or handed the handle to an implementation that never issued it.
Capture the request/cancel pair, and setTimeout/clearTimeout for the fallback,
at schedule time and always cancel through the captured function.

Make the inline-math regression tests fast and deterministic on a loaded
runner without dropping what they pin:

- Budget tests use distinct formulas padded with trailing spaces to 1,900
  source characters. The budget counts source characters, so they cross it
  exactly like the old 1,357-character matrices, at a fraction of the
  typesetting cost.
- The uncacheable-render test uses 40 radicals per formula: each render is
  still over the 64,000-character cache entry limit (asserted), several times
  cheaper than a large matrix.
- Idle-time work runs through a stubbed idle queue that the test flushes,
  instead of polling wall-clock timers; a fake-timer test covers the
  setTimeout fallback.
- The snapshot tests replace KaTeX with a trivial typesetter (real
  typesetting is covered by the element tests), use the minimum fixture that
  crosses the per-root cap (2 x 501 formulas), wait for the deferred unmount
  before restoring stubs, and count formulas only within the tree being
  measured.

The [600, 600, 600, 600] measurement in the failed release run was a cascade:
slideToPng timed out, kept running, and its off-screen tree was still in
document.body when the next test counted roots across the whole body. Its
deferred unmount then ran after the idle stubs were restored, which is what
raised the unhandled TypeError.

New tests cancel after cancelIdleCallback is removed or replaced, and after
clearTimeout is replaced; they fail on the previous implementation.

Bump @openmaic/renderer to 0.1.14 so the next publish run releases it
(0.1.13 never reached the registry).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(packages): keep release-gate tests stable on a loaded runner

The publish workflow runs every package's tests concurrently on one runner.
Two more checks in that step failed when the suites were run under CPU
contention:

- The macro-safety tests in editor, generation and importer asserted that a
  render takes under 100 ms. On a loaded runner a guarded render can exceed
  that. Raise the ceiling to 1 s: the unguarded nestedDef expansion takes tens
  of seconds, a guarded render a few milliseconds, and the output-size and
  error checks that follow are what show the definitions were dropped.
- Editor tests never unmounted their trees, because Testing Library only
  registers automatic cleanup when the runner exposes a global afterEach.
  React work still queued at the end of a file then ran after jsdom was torn
  down ("window is not defined"). Clean up after each test in the shared
  setup.

Test-only changes; no package version bumps are required.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* fix(tests): make the suite reliable on Windows and newer Node runtimes (#1890)

- tests/ci/publish-openmaic-skill.test.ts: resolve bash the way PATH
  finds it on Windows (/bin/bash elsewhere) and join PATH with
  path.delimiter. All 16 cases failed on Windows before this.
- tests/store/kv-persist.test.ts: dedupe standing-problem reports per
  key; how many recovery attempts elapse inside flushTasks is
  wall-clock, not code.
- tests/workbench/workspace-rail-session-rename.test.ts: wait for the
  row/menu with vi.waitFor(..., { timeout: 30_000 }) and give the suite
  its own 30s budget for the cold dynamic import of the rail.
- tests/lint-llm-entry-guard.test.ts: 120s suite timeout — every case
  runs the real eslint over every guarded path.

The media-orchestrator part of the original change is dropped: upstream
rewrote that suite and removed the fragile microtask-hop waits it
targeted.

No production code, no global config changes, no assertion weakened.

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(generation): parse data URLs without regex and cap vision image size (#1902)

## Summary

Large or unsupported images attached to vision requests can crash prompt building or be rejected by the model provider, and a single bad image fails the whole generation step (retries fail the same way).

- **`@openmaic/generation` 0.3.19**: `buildVisionUserContent` no longer runs a regex over the whole data URL. A new exported `parseBase64DataUrl` splits header and payload with plain string ops, so multi-megabyte payloads are never scanned by the regex engine.
- **Vision image cap (app)**: new `prepareVisionImages` (`lib/server/generation/vision-images.ts`) runs right before every vision call — outline, scene content, scene actions, and the PBL evaluator (which receives uploaded submissions).
  - Pass-through only for single-frame, 8-bit sRGB/grayscale png/jpeg/webp/gif whose **base64 payload** is within `MAX_VISION_IMAGE_BASE64_BYTES` (1 MiB — providers measure the encoded payload) and whose longest side is within `MAX_VISION_IMAGE_DIMENSION` (2048 px). Pixels are strictly decoded first so truncated data is caught. http(s) URLs are untouched.
  - Everything else (oversized, animated, CMYK, 16-bit, unsupported formats) is decoded once with sharp (first frame, EXIF-rotated, resized inside 2048, flattened on white, sRGB) and encoded to JPEG, stepping quality down until under the cap.
  - Images that still don't fit or can't be decoded are dropped with a warning; the step continues.
  - Preparation runs where vision images are resolved (outline and scene-content pre-resolution), so the prompt's "[see attached]" placeholders and asset-id mappings only describe images that are actually attached. The PBL evaluator logs when an image submission is evaluated without its image.
  - Processing is sequential to bound peak memory.

Non-goals: no change to material upload/extraction, prompts, or generation logic.

## Test plan

- [x] `pnpm check`, `pnpm lint`, `npx tsc --noEmit`
- [x] `@openmaic/generation` build + typecheck + tests (incl. an 8 MiB payload, malformed and non-base64 data URLs, http passthrough)
- [x] New `tests/generation/vision-images.test.ts` (small untouched, large downscaled under caps, unsupported format converted, undecodable dropped while others kept, http untouched); updated scene-content / retry-boundary / evaluator tests
- [x] Full `pnpm test` (Node 22)
- [x] `node scripts/check-package-version-bumps.mjs origin/main`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

* fix: typeset inline math in render-service previews and export it cleanly to PPTX (#1904)

* fix(render-service): typeset inline math in slide previews

Slide prose now stores an inline formula as its LaTeX source
(<span data-inline-math="SRC">SRC</span>) and leaves typesetting to the
renderer. render-service pinned @openmaic/renderer 0.1.4, which predates
that, so a slide preview showed the raw source (for example
"\frac{a}{b}") instead of the formula.

- Bump @openmaic/renderer to 0.1.14 and @openmaic/dsl to 0.11.3. The
  changes in between are additive for this service: SlideCanvas props are
  unchanged, the new dsl exports are math hardening and chart style types,
  and charts still render with the lazily loaded ECharts runtime.
- Call completeInlineMath after mounting the slide. The live renderer
  typesets at most 100 formulas per pass before paint and leaves the rest
  to idle time; a capture needs all of them.
- Ship KaTeX's stylesheet with slide previews. KaTeX HTML needs its CSS and
  math fonts: without them, typeset formulas lose their layout (a/b reads
  "ba"). The preview document is an about:blank page, so each font face is
  inlined as its woff2 data URL. The CSS is read from the KaTeX copy the
  renderer resolves, once per process. This also gives LaTeX elements that
  carry a KaTeX HTML snapshot the styles they were missing.

Tests: the stylesheet inlines every face, and a real Chromium preview of
150 stored formulas, with idle callbacks disabled, typesets all of them in
KaTeX fonts before capture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): write inline formulas to PPTX as their LaTeX source

A stored inline formula (<span data-inline-math="SRC">SRC</span>)
already exports as its source text, since the span's text is the source.
Prose that has not been saved yet still carries the editor's rendered
KaTeX tree, and the PPTX text walk wrote every text node in it: the
MathML text, the TeX annotation and each layout glyph as separate runs,
so E=mc^2 became "E=mc2E=mc^2E=mc2". KaTeX from a PPTX import (only a
TeX annotation, no attribute) came out the same way, and table cells
were written verbatim, tags and character references included.

- Treat an inline formula as one run holding its LaTeX source, with the
  same parse rules as the editor: span[data-inline-math], else span.katex
  with a TeX annotation. The run keeps the surrounding text style.
- Write table cell text as plain text: tags dropped, character
  references decoded (stored cells hold "R&amp;D"), breaks and paragraphs
  as newlines, formulas as their source. Cells without markup are
  unchanged.

Formulas stay LaTeX text, not native equations: inline OMML in a text
run needs PowerPoint's AlternateContent wrapper per text shape, which is
left for a separate change that can be checked in PowerPoint.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): keep table cell lines when converting cells for PPTX

The table cell conversion sent any cell containing `&` through the HTML
path, which dropped newlines: plain text "R&D\nSales" exported as one
paragraph "R&DSales" instead of two. It also dropped empty paragraphs, so
<p>A</p><p></p><p>B</p> lost its blank line.

- Only text with a tag or comment takes the HTML path. Plain text has its
  character references decoded and keeps its lines.
- In markup, a newline in the text starts a new line, as the slide
  renderer shows it (it turns cell newlines into line breaks), and so do
  <br> and each paragraph. An empty paragraph is an empty line; a
  paragraph that already ended on a break (a trailing <br>, a nested
  block) adds no further line.

Tests read the paragraphs of each exported table cell from the slide XML.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(slide-renderer): keep the uncacheable inline math test fast on a loaded runner

The app slide renderer's "formulas too large to cache" test typeset six
1,360-character matrices (about 170 KB of markup each) in two elements and
polled wall-clock timers for idle work. On a loaded CI runner it ran past
the 5 s test timeout. Apply the approach the renderer package's own tests
already use, keeping what the test pins:

- Each formula is 40 radicals padded with trailing spaces to 1,900 source
  characters. Six still cross the 4,000-character per-pass budget, and
  each render is still over the typeset cache's 64,000-character
  per-entry limit, now asserted, so every re-typeset stays full price.
- Idle work runs through a stubbed idle queue that the test flushes,
  instead of polling timers.
- The test now also asserts that the first pass leaves formulas for later.

The other tests in the file typeset one short formula each and are
unchanged. Under CPU load (12 busy loops plus 12 concurrent runs on 12
cores) the test takes about 2.0 s, down from about 4.1 s; unloaded,
0.32 s, down from 1.0 s.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* test(renderer): give heavy inline-math typesetting suites room on loaded runners (#1907)

## Summary

The package release gate (`publish-packages.yml` → "Validate release candidate") runs the `@openmaic/*` package suites concurrently. The suites that typeset ~1,000 KaTeX formulas (the inline-math hard-cap cases) take ~0.3–0.4 s each locally but exceed vitest's 5 s default on a loaded runner: the release run for fccbf82c failed twice on `inline math typesetting budget > shows formulas past the hard cap as text`, which blocks publishing `@openmaic/generation@0.3.19`. The same class of test (`tests/slide-renderer/inline-math-elements.test.ts` › "keeps progress through repeated commits with formulas too large to cache") also timed out once in the app unit-test job.

This raises the timeout to 30 s for only the four suites that contain those heavy cases (describe-level `{ timeout: 30_000 }`). No product code changes; test files are not publishable inputs, so no version bump.

## Test plan

- [x] Renderer `test/elements/text/inlineMath.test.tsx` + `test/snapshot/inlineMath.test.tsx` (30 passed)
- [x] `tests/slide-renderer/inline-math-elements.test.ts` (5 passed)
- [x] `pnpm check`, `pnpm lint`, `npx tsc --noEmit`, `node scripts/check-package-version-bumps.mjs origin/main`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

* fix(pi): require Google native for official Gemini compatible route (#1897)

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* feat(settings): warn users before submitting API keys  (#1158)

* fix(settings): warn for all rendered credentials / 修复所有凭据输入字段的安全提示

* fix(settings): preserve credential notices after upstream merge

* fix(settings): remove stale credential notice import

* fix(i18n): align credential storage hint translations

* refactor(settings): compact credential storage hint

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* docs(generation): document shape rotation semantics [AI-assisted] (#1872)

* docs(generation): document shape rotation semantics

* fix(generation): clarify optional shape rotation examples

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(pi): reject null storeState.scenes members with 400 (#1821) (#1893)

* fix(pi): reject null members of storeState.scenes (#1821)

A null member of storeState.scenes made POST /api/chat/pi return HTTP 500,
or HTTP 200 followed by a stream error, outside the slide-reference check
from #1752. Reject that shape once on the route, before reference
resolution and model resolution, with the existing INVALID_REQUEST 400.

Closes #1821

* fix(pi): reject every non-object member of storeState.scenes (#1821)

Reject primitives and arrays as well as null/undefined, per review, and
report 'storeState.scenes members must be objects'.

---------

Co-authored-by: Frank-zhu2000 <332350688+Frank-zhu2000@users.noreply.github.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* docs: v1.2.0 news, classroom export guide and complete upgrade notes (#1916)

* docs: announce v1.2.0 and add a classroom export guide

- README / README-zh: replace the rc.1 news entry with the 1.2.0 GA entry
  (server-first is stable, classroom export), describe the new export
  formats in the highlights and the export table, point to the model
  authorization docs, and note the render-service upgrade order.
- Getting started (all locales): new "Export a classroom" section covering
  PPTX with placeholder slides or slides only, the Resource Pack, offline
  HTML with or without narration, the ZIP used above 400 MB, the classroom
  ZIP, and opening an exported file on a phone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: complete the 1.2.0 upgrade notes in every locale

- Deployment (all locales): before the first start, list the models of
  providers with server-managed credentials, upgrade the render-service
  together with or before the app, and check the Pi classroom model
  (tool calling, native Gemini preset). The Vercel section no longer
  mentions a README Deploy button that no longer exists; the MP4 section
  notes the render-service upgrade order.
- Configuration (all locales): document the tool_calling_required refusal
  of Pi classroom chat; translate the model authorization section, which
  was still in English in every localized page; add the GLM Image
  provider example missing from ja, zh-tw, ru and ar; fix a broken bold
  span in ja.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: move the 1.2.0 date to 2026-10-16 and scope two statements

- README / README-zh: the v1.2.0 news entry is dated 2026-10-16; the
  model list row applies to providers that select an upstream model.
- Getting started (all locales): offline HTML keeps only the briefing of
  a project-based learning scene; continuing the project needs the
  online classroom and a network connection.
- Deployment (all locales): the model list step applies to providers
  that send a selected model upstream; services without model selection,
  such as Tavily or a document parser, need no list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: note unbundled assets in the offline HTML export

Getting started (all locales): if the export reports assets it could not
bundle, those parts of interactive scenes still load from the network,
as the README already describes for classroom exports.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: correct the unbundled asset note for offline HTML

The standalone HTML's content security policy blocks remote URLs even
when the device is online, so assets the export could not bundle do not
show in the offline file; they remain available in the online classroom.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* release: v1.2.0 (#1917)

* release: v1.2.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* release: date v1.2.0 2026-10-16 and clarify the cumulative scope

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* release: scope the math-hardening note to the app's render paths

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(web-search): add Kimi search with shared chat credentials (opt-in) (#1911)

* feat(web-search): add Kimi search with shared chat credentials

* fix(web-search): require explicit Kimi search opt-in

* fix(web-search): preserve search defaults after Kimi opt-in

* fix(web-search): warn when Kimi opt-in needs a slot assignment

* feat(web-fetch): add webFetch capability slot with a provider registry (builtin, Kimi) (#1912)

* feat(web-fetch): add provider registry and capability slot

* fix(web-fetch): protect defaults and unify capability execution

* fix(web-fetch): preserve workspace credentials and reuse proxy agents

* fix(web-fetch): retry transient Kimi transport failures

* feat(settings): show web fetch inside the research station

Draw the web fetch slot as a third line (fetch) of the research station
instead of an unconnected station of its own, and describe it as the
agent's page reader, since course generation itself only searches.

- Offer the implicit built-in reader as the slot's server default, so the
  picker shows the same server-default row as with a configured provider.
- Anchor slot pickers to their station card so an open picker never
  covers the card it belongs to.
- Localize the picker's provider group label in zh-CN and zh-TW.

* test(config): verify shared Kimi search and fetch capabilities

* fix(generation): reject invalid shape rotations (#1891)

* fix(generation): reject invalid shape rotations

Signed-off-by: jianghh <3232826884@qq.com>

* fix(generation): report non-finite shape rotations

* test(generation): format rotation regression

* fix(generation): skip null generated elements

---------

Signed-off-by: jianghh <3232826884@qq.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* fix(i18n): resolve the initial locale on the server so SSR and hydration agree (AI-assisted) (#1874)

* fix(i18n): resolve the initial locale once on the server and hydrate with it

The root layout now picks the UI locale from the locale cookie, then
Accept-Language, then defaultLocale, renders <html lang> with it, and hands
the locale and its bundle to I18nProvider. The client starts from that value
instead of re-detecting, so the first client render matches the server HTML.

setLocale persists the choice to the cookie (and localStorage) immediately,
loads the new bundle, and commits the locale to React state only once the
bundle is in, dropping a slower earlier switch. A failed load keeps the
current locale and restores the previous choice; a later attempt loads
again. The provider keeps its useTranslation subscription so loads still
re-render. A choice stored only in localStorage by earlier versions is
carried over to the cookie once.

Fixes #1445
Fixes #1536

* fix(i18n): refresh the locale cookie and localStorage mirror on load

When the locale cookie matches the server's choice, write it again on
mount so Safari's 7-day cap on script-set cookies doesn't expire it, and
so localStorage.locale (still read by PBL) follows the server's choice.

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* feat(token-plan): let plans declare web fetch; Kimi Coding Plan takes over web fetch (#1927)

* feat(token-plan): support declared web fetch capabilities

* fix(token-plan): take over implicit builtin fetch defaults

* docs(token-plan): include web fetch in modality descriptions

* fix(chat): save chats without Web Locks on insecure origins (#1929)

* fix(chat): save chats without Web Locks on insecure origins

On plain HTTP at a non-localhost address (a LAN IP, a Tailscale IP or
MagicDNS name) the page is not a secure context and navigator.locks is
undefined. The chat partition lock still required it for the default
store, so loading chats failed silently and every stage flush threw
ChatStorageLockUnavailableError, retrying with backoff and re-uploading
the document each time.

The rule dates from when the default path also migrated and cleared a
browser database shared across tabs. That migration is gone, and the
isolated write mode already used without a shared mutex gives the same
per-chat last-writer-wins result as the locked path. When Web Locks are
missing, use it and log a one-time notice.

Also include the error name and message when a WebKit stack lists only
frames, and document the HTTP limitation in the deployment guide.

Fixes #1800.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(logger): check for the Name: message header, not a substring

A frame-only stack can contain the message by coincidence (a function
named like it) and every stack contains an empty message.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(deployment): note that deletes win over concurrent edits without Web Locks

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(chat): add suggested replies to cue_user (#1379)

* feat(chat): mature learner handoff flow

* refactor(roundtable): embed learner handoff in dialogue

* fix(chat): preserve learner handoffs across server restore

* style(roundtable): clarify learner quick replies

* fix(chat): address durable learner handoff review

* fix(chat): preserve long sessions and learner cue presentation

* feat(chat): limit cue_user to optional string suggestions

* feat(chat): show cue_user suggestions in the learner's reply bubble

Move the quick replies out of the separate chip row and into a
"suggested reply" bubble in the user-bubble slot: same right alignment,
corner and avatar as the real user bubble, but a light dashed outline so
it reads as "you could say". Chips wrap (two visible rows, scrolling
inside the bubble's existing max height, with a fade when more are
below) and truncate long labels with a tooltip. In fullscreen the bubble
sits in the right-hand stack above the dock. The centered "Your turn"
cue is unchanged on normal-width stages; on very narrow stages it yields
its space while suggestions are shown. The roundtable stays 192px.

Drop the hard JSON-schema bounds on cue_user (prompt length, option
count and option length) and keep them in the parameter descriptions,
so an over-limit call is normalized by normalizeCueUserOptions instead
of being rejected during argument validation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(chat): retire the legacy director-graph classroom chat (#1913)

* refactor(chat): move Pi's shared parser, action schemas and store-state type out of the legacy chat owners

Pi classroom chat still imports three pieces from the legacy director-graph
chat, which #1814 retires. Give each a Pi or neutral owner first, so the
legacy files can later be deleted without touching Pi:

- The structured-output parser (createParserState, parseStructuredChunk,
  finalizeParser, looksLikeStructuredFragment, ParseResult) moves verbatim
  from lib/orchestration/stateless-generate.ts to lib/chat/structured-output.ts.
  Only two comments change: they no longer name director-graph as the reader
  of the per-call ordered indices. This also stops the Pi route from loading
  director-graph and LangGraph through the parser's module.
- lib/orchestration/tool-schemas.ts moves unchanged to lib/chat/pi/tool-schemas.ts.
- AgentLoopStoreState moves unchanged from lib/chat/agent-loop.ts to
  lib/chat/store-state.ts; the Pi request path in use-chat-sessions uses it.

The remaining legacy consumers import from the new locations until they are
removed. No behavior change.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(chat): cover classroom model precedence on /api/chat/pi with the real resolver

The user-route, lock and body precedence for classroom interaction is
covered with the real resolveModel only through the legacy /api/chat
route, which #1814 removes. Route-level Pi tests mock resolveModel. Add the
same four cases against /api/chat/pi, asserting the model handed to the Pi
runtime:

- a chat-adapter user route wins over the body model;
- a locked classroom slot wins over the user route;
- with no matching route, the body model is used;
- a locked classroom slot is kept despite unlisted body and route models.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(eval): run the whiteboard layout eval against Pi classroom chat

The whiteboard eval drove the legacy /api/chat through runAgentLoop. Point
it at /api/chat/pi, which #1814 keeps as the only classroom chat:

- one Pi request per scripted user turn, with whiteboard tools enabled as
  the app does for in-class requests;
- text and actions grouped by each agent's messageId and sealed into their
  own history message at agent_end, since one Pi request can hand the turn
  to several agents;
- the previous turn's done.directorState carried into the next request
  within a scenario run, as the app does within a session;
- an error event, a non-200 response, or a stream without done fails the
  scenario through the existing error path, which skips its remaining turns
  (previously an error event was swallowed and the turn still captured);
- a native whiteboard event fails the run, because the harness cannot see
  the native child's server-side board. Not seeing one does not prove the
  server uses the legacy child; run the eval on a server configured for it.

Scores are a new baseline and are not comparable with runs of the legacy
runner. Scenarios, capture, scoring and reporting are unchanged.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(eval): settle queued actions and cancel the request when a whiteboard turn fails

Review of the Pi whiteboard runner (#1913) found two lifecycle gaps on the
failure paths it added:

- A turn that failed (an SSE error, a native whiteboard event, or EOF without
  done) returned and disposed the scenario without waiting for its queued
  actions. The state manager drives shared store singletons, so a pending
  action could finish inside the next scenario and land in its screenshot.
  Every turn exit now settles the action queue first. A queued rejection is
  handled while the stream is still open and is logged at settle time, as on
  the success path, without replacing the turn's own error.
- Stopping early only released the reader lock, so the request kept running.
  Each turn's request now has its own AbortController, aborted on exit, and an
  unfinished response body is cancelled before the lock is released.

runScenario is exported with its CLI settings passed in, and main() runs only
when the file is the entry point, so an offline Vitest suite can exercise the
real function: failed turns settle before returning, the native early exit
aborts and cancels, a concurrent action rejection is not unhandled, and the
success path keeps one Pi request per turn, messageId grouping, directorState
carry-over and score:null on scorer failure.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(eval): run the answering and answer-content evals on Pi; retire premature-end

Both evals drove the legacy single-step director prompt and agent prompt,
which #1814 retires. Run them on the real Pi director in process instead
(eval/orchestration/pi-harness.ts): the Pi config helpers supply agent
configs and budgets, whiteboard tools are on as for classroom requests,
thinking is off, and the legacy child runtime is pinned. The harness skips
the HTTP route, so route authorization and tool-capability checks are not
exercised.

- answering classifies by the first recorded call_agent attempt in the
  director tool trace: TEACHER, OTHER_AGENT (another or a non-existent agent),
  NO_DISPATCH (none recorded; wrong, kept in the denominator), or ERROR (a
  failed run, excluded as before). A later recorded attempt never rescues
  the first.
- answer-content judges the full reply of the first recorded teacher attempt.
  A failed run, no recorded teacher attempt, or a first one that is skipped,
  marked isError or empty scores 0. The judge, opening window, threshold and
  all-samples denominator are unchanged. Pi's short teacher replies make the
  two metrics nearly coincide, and the score includes routing.
- Both score only what the trace records. A schema-rejected attempt is not
  recorded, so a later one can score, and a legacy child's partial text after
  a provider failure is judged. Scores can be overstated. Real-chain tests
  (real Pi loop and agent SDK, scripted StreamFn) pin both limits.
- The old prompt A/B variants are removed; results are a Pi baseline.
- premature-end is retired: its single END decision has no Pi counterpart,
  and the close gate does not show a question was answered.
- The three remaining eval scripts load with tsx --conditions=import, so
  ESM-only dependencies resolve.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(chat): always run classroom chat on Pi and fail builds that still opt out

The classroom chat hook, the /api/chat/pi route and PlaybackChromeRoot no
longer read NEXT_PUBLIC_PI_CHAT_ENABLED. The hook sends every turn through
the existing Pi single-request path; the frontend no longer calls the legacy
/api/chat loop (fetchStatelessChat and the runAgentLoop tail are removed).
The Pi branch itself is unchanged apart from indentation.

isPiChatEnabled and its readDefaultOnBoolean helper are removed. The
independent courseware-reference gate stays default-off.

next.config.ts now exports a phase function. In the production-build phase
it fails when NEXT_PUBLIC_PI_CHAT_ENABLED is set to anything other than '',
'true' or '1' (exact match), which covers every value that used to select
the legacy runtime. The error names the value and points to the Classroom
model setting, the google native preset for Gemini, and the administrator
for managed configurations. Other phases do not check the flag. The fixed
env pin for the flag is removed.

This is an intermediate step of #1814 PR 3: the legacy route, director graph
and agent loop are still present and are removed in a follow-up commit, and
Docker/Compose wiring and docs still describe the old rollback.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(chat): remove the legacy director-graph classroom chat backend

The frontend has run every classroom turn on /api/chat/pi since the previous
commit, so nothing reaches the legacy stack any more. Remove it:

- app/api/chat/route.ts (no stub, redirect or 410; /api/chat/pi stays)
- lib/orchestration/{stateless-generate,director-graph,ai-sdk-adapter,
  director-prompt,prompt-builder}.ts and lib/chat/agent-loop.ts
- summarizers/{conversation-summary,message-converter}.ts
- the director, agent-system and agent-system-wb-* templates, the
  speech-guidelines and whiteboard-reference snippets, and their prompt and
  snippet IDs

Pi's default legacy child, the shared structured-output parser, the Pi
tool schemas, the shared summarizers, the registry and the protocol types
are unchanged. Dependency declarations are left for a follow-up commit.

Tests:
- Drop the legacy chat route from the model-authorization tests and the
  coverage matrix. The mixed compatibility cases keep their six and eight
  stage assertions, and the exhaustive resolver call-site scan is unchanged.
  The locked-classroom case now goes through /api/chat/pi.
- Retire chat-route-user-routes (its precedence cases are rebuilt on the Pi
  route in route-model-precedence), the agent-loop async-state test, and the
  conversation-summary test.
- Keep the #511 intent as a history input contract on Pi:
  toHistoryMessages keeps the human challenge as a user turn in order, and
  buildUserPrompt still reports it after a later agent reply.
- Move the role, peer-context and language-directive prompt checks onto
  Pi's buildChildPrompt. Keep the PBL and placeholder-lint template tests and
  the getActionDescriptions LaTeX guard.
- Add middleware cases for POST /api/chat (401 without access, pass-through
  otherwise) and a Playwright spec that expects a plain 404 from the running
  app.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* build(deps): drop the unused @langchain/langgraph dependency

The legacy director graph was its only consumer and was removed in the
previous commit. Remove the root declaration and let pnpm update the
lockfile: @langchain/langgraph and @langchain/langgraph-checkpoint are no
longer installed. @langchain/langgraph-sdk stays (an optional CopilotKit
peer and a direct dependency of @ag-ui/langgraph).

@langchain/core is kept: CopilotKit requires it as a peer and pnpm would
install it anyway. partial-json and jsonrepair are kept for the Pi parser.

The re-resolution also moved vite 8.0.0's postcss from 8.5.15 to 8.5.23
(both were already in the lockfile; Next's postcss is unchanged) and
shortened four eslint-import snapshot keys without changing versions.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* build(docker): keep the Pi chat flag only as an input to the build check

NEXT_PUBLIC_PI_CHAT_ENABLED no longer selects a chat runtime; next.config.ts
only reads it to fail a production build that still opts out of Pi. Keep the
builder ARG and the Compose build-arg forwarding so an explicit false still
reaches that check, and drop the ENV line: build args are already visible to
the builder's RUN steps, and the value has nothing to configure in the image.

Remove the legacy-chat rollback comment and command from docker-compose.yml
and replace the rollback section of .env.example with a short note that the
legacy runtime is gone and which values now fail the build.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: describe classroom chat after the legacy runtime removal

- Configuration docs (all six locales): drop the Pi rollback example, the
  advice to rebuild with the flag set to false and the Compose rollback
  command. Say instead that classroom chat always runs on Pi and needs a
  tool-calling Classroom model (google preset for Gemini), that the flag
  should be removed, which exact values a production build still accepts,
  and that the Compose service env_file supplies runtime values only.
- READMEs: drop the LangGraph badge and describe lib/orchestration and the
  Pi director loop as they now are.
- CHANGELOG: add the breaking change (model requirement, the flag, POST
  /api/chat answering 404 after the access gate) and the dependency removal.
- lib/prompts/README.md: point the role and length guidelines at
  lib/chat/pi/prompts.ts, correct which tests check placeholders, use a
  missing snippet in the error example, and start the whiteboard eval server
  with the native child runtime off.
- Remove the two comments that told CI and Playwright to leave the flag
  unset.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(chat): pin the server key on a user-route model; document answering eval limits

- route-model-precedence: when the user route switches the classroom model
  to another provider without a key of its own, assert that the model is
  built with the server key rather than the body's key.
- answering eval: state in the header comment and the generated report that
  a run which throws, is aborted or ends without done is ERROR even after it
  dispatched an agent, that ERROR samples stay out of the correct-rate
  denominator, and what the rate therefore does and does not measure. The
  scoring rules are unchanged.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>

* feat(web-tools): add DeepSeek search and fetch providers (#1937)

* feat(web-tools): add DeepSeek search and fetch providers

Add DeepSeek as a web search provider (POST /v1/tools/search) and a hosted
web fetch provider (POST /v1/tools/fetch). Both reuse the `deepseek` chat
credentials, following the existing Kimi wiring.

- Search is opt-in: `WEB_SEARCH_DEEPSEEK_ENABLED=true`, an explicit
  `web-search.deepseek` entry, or an explicit `webSearch` slot in
  openmaic.yml. Adding DeepSeek for chat never assigns search.
- Queries are truncated to 128 code points; `summary` is preferred over
  `snippet`.
- Fetch keeps Kimi's timeouts and single transport-error retry; 403/404
  surface as clear "cannot fetch" errors.
- Official hosts normalize to /v1; a deployment-configured gateway base URL
  is preserved for both tools.
- Docs (6 languages), .env.example, i18n provider names and tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(web-search): accept official workspace provider endpoints

Reuse registry allowlists for workspace tool endpoint resolution, save validation, and model settings capabilities. Cover DeepSeek and Kimi official URLs with trailing slashes, reject custom endpoints, and preserve web fetch behavior.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* docs(contributing): document how app versions are chosen (#1938)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* feat(web-fetch): add Firecrawl provider (#1931)

* feat(web-fetch): add Firecrawl provider

* test(web-fetch): pin Firecrawl's post-redirect url as the final URL

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* chore(models): remove retired models from the built-in registry (#1939)

* chore(models): remove retired models from the built-in registry

Check every built-in model catalog against the vendors' current model lists
and retirement notices, and remove the models that are already shut down
(DeepSeek, Qwen, Kimi, SiliconFlow, xAI, Tencent, Xiaomi, Doubao/Seed,
Google image and Veo, and the Ark Agent Plan). Retired defaults are replaced
with the vendor's current recommendation (for example `deepseek-flash`), and
the Ark Agent Plan gains the replacements its migration notice lists.

Models that are deprecated but still served stay in the catalog; the
CHANGELOG lists their shutdown dates, the IDs that vendors still route to a
successor, and the Qwen voice-clone limitation. The supported-models tables
in all six languages are realigned with the catalogs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(models): keep retired DeepSeek Flash IDs resolving to deepseek-flash

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(models): resolve other vendor-routed retired IDs to catalog successors

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore: restore the App Releases section dropped while rebasing

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

---------

Signed-off-by: jianghh <3232826884@qq.com>
Co-authored-by: Ethereal49 <hongyeluo49@gmail.com>
Co-authored-by: Tiyatrotist <tiyatrotist@gmail.com>
Co-authored-by: Tiyatrotist <179411334+Tiyatrotist@users.noreply.github.com>
Co-authored-by: Matt Van Horn <mvanhorn@users.noreply.github.com>
Co-authored-by: Matt Van Horn <455140+mvanhorn@users.noreply.github.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Yizuki_Ame <yinzimike@gmail.com>
Co-authored-by: Cham1229 <luhaocheng729@gmail.com>
Co-authored-by: cham <2577781125@qq.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Jinhui Hu <75174330+VenusHui@users.noreply.github.com>
Co-authored-by: Hahaa909 <162872815+Hahaa909@users.noreply.github.com>
Co-authored-by: DDL <duanjialing.777@bytedance.com>
Co-authored-by: weinaike <13814354+weinaike@users.noreply.github.com>
Co-authored-by: I3ob0 <huzi0404@163.com>
Co-authored-by: LING DUAN <duan.lin@northeastern.edu>
Co-authored-by: BeAIcoder <jacky.destiny@outlook.com>
Co-authored-by: yipwingtim <jwen@fudan.edu.cn>
Co-authored-by: jack <zhuzhijian04@gmail.com>
Co-authored-by: Frank-zhu2000 <332350688+Frank-zhu2000@users.noreply.github.com>
Co-authored-by: John Costa <costajohnt@gmail.com>
Co-authored-by: Yanpeng Wang <yanpg.wang@gmail.com>
2026-10-18 17:59:53 +08:00
wyucandClaude Opus 5.5 bf6fe34028 chore(models): remove retired models from the built-in registry (#1939)
* chore(models): remove retired models from the built-in registry

Check every built-in model catalog against the vendors' current model lists
and retirement notices, and remove the models that are already shut down
(DeepSeek, Qwen, Kimi, SiliconFlow, xAI, Tencent, Xiaomi, Doubao/Seed,
Google image and Veo, and the Ark Agent Plan). Retired defaults are replaced
with the vendor's current recommendation (for example `deepseek-flash`), and
the Ark Agent Plan gains the replacements its migration notice lists.

Models that are deprecated but still served stay in the catalog; the
CHANGELOG lists their shutdown dates, the IDs that vendors still route to a
successor, and the Qwen voice-clone limitation. The supported-models tables
in all six languages are realigned with the catalogs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(models): keep retired DeepSeek Flash IDs resolving to deepseek-flash

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(models): resolve other vendor-routed retired IDs to catalog successors

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* chore: restore the App Releases section dropped while rebasing

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:24:38 +08:00
fd5e1d4367 feat(web-fetch): add Firecrawl provider (#1931)
* feat(web-fetch): add Firecrawl provider

* test(web-fetch): pin Firecrawl's post-redirect url as the final URL

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 17:16:52 +08:00
wyucandClaude Opus 5.5 7f8d27641e docs(contributing): document how app versions are chosen (#1938)
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 16:24:33 +08:00
wyucandClaude Opus 5.5 3d6fe7b6b3 feat(web-tools): add DeepSeek search and fetch providers (#1937)
* feat(web-tools): add DeepSeek search and fetch providers

Add DeepSeek as a web search provider (POST /v1/tools/search) and a hosted
web fetch provider (POST /v1/tools/fetch). Both reuse the `deepseek` chat
credentials, following the existing Kimi wiring.

- Search is opt-in: `WEB_SEARCH_DEEPSEEK_ENABLED=true`, an explicit
  `web-search.deepseek` entry, or an explicit `webSearch` slot in
  openmaic.yml. Adding DeepSeek for chat never assigns search.
- Queries are truncated to 128 code points; `summary` is preferred over
  `snippet`.
- Fetch keeps Kimi's timeouts and single transport-error retry; 403/404
  surface as clear "cannot fetch" errors.
- Official hosts normalize to /v1; a deployment-configured gateway base URL
  is preserved for both tools.
- Docs (6 languages), .env.example, i18n provider names and tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(web-search): accept official workspace provider endpoints

Reuse registry allowlists for workspace tool endpoint resolution, save validation, and model settings capabilities. Cover DeepSeek and Kimi official URLs with trailing slashes, reject custom endpoints, and preserve web fetch behavior.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 00:59:30 +08:00
6760c2b764 refactor(chat): retire the legacy director-graph classroom chat (#1913)
* refactor(chat): move Pi's shared parser, action schemas and store-state type out of the legacy chat owners

Pi classroom chat still imports three pieces from the legacy director-graph
chat, which #1814 retires. Give each a Pi or neutral owner first, so the
legacy files can later be deleted without touching Pi:

- The structured-output parser (createParserState, parseStructuredChunk,
  finalizeParser, looksLikeStructuredFragment, ParseResult) moves verbatim
  from lib/orchestration/stateless-generate.ts to lib/chat/structured-output.ts.
  Only two comments change: they no longer name director-graph as the reader
  of the per-call ordered indices. This also stops the Pi route from loading
  director-graph and LangGraph through the parser's module.
- lib/orchestration/tool-schemas.ts moves unchanged to lib/chat/pi/tool-schemas.ts.
- AgentLoopStoreState moves unchanged from lib/chat/agent-loop.ts to
  lib/chat/store-state.ts; the Pi request path in use-chat-sessions uses it.

The remaining legacy consumers import from the new locations until they are
removed. No behavior change.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(chat): cover classroom model precedence on /api/chat/pi with the real resolver

The user-route, lock and body precedence for classroom interaction is
covered with the real resolveModel only through the legacy /api/chat
route, which #1814 removes. Route-level Pi tests mock resolveModel. Add the
same four cases against /api/chat/pi, asserting the model handed to the Pi
runtime:

- a chat-adapter user route wins over the body model;
- a locked classroom slot wins over the user route;
- with no matching route, the body model is used;
- a locked classroom slot is kept despite unlisted body and route models.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(eval): run the whiteboard layout eval against Pi classroom chat

The whiteboard eval drove the legacy /api/chat through runAgentLoop. Point
it at /api/chat/pi, which #1814 keeps as the only classroom chat:

- one Pi request per scripted user turn, with whiteboard tools enabled as
  the app does for in-class requests;
- text and actions grouped by each agent's messageId and sealed into their
  own history message at agent_end, since one Pi request can hand the turn
  to several agents;
- the previous turn's done.directorState carried into the next request
  within a scenario run, as the app does within a session;
- an error event, a non-200 response, or a stream without done fails the
  scenario through the existing error path, which skips its remaining turns
  (previously an error event was swallowed and the turn still captured);
- a native whiteboard event fails the run, because the harness cannot see
  the native child's server-side board. Not seeing one does not prove the
  server uses the legacy child; run the eval on a server configured for it.

Scores are a new baseline and are not comparable with runs of the legacy
runner. Scenarios, capture, scoring and reporting are unchanged.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(eval): settle queued actions and cancel the request when a whiteboard turn fails

Review of the Pi whiteboard runner (#1913) found two lifecycle gaps on the
failure paths it added:

- A turn that failed (an SSE error, a native whiteboard event, or EOF without
  done) returned and disposed the scenario without waiting for its queued
  actions. The state manager drives shared store singletons, so a pending
  action could finish inside the next scenario and land in its screenshot.
  Every turn exit now settles the action queue first. A queued rejection is
  handled while the stream is still open and is logged at settle time, as on
  the success path, without replacing the turn's own error.
- Stopping early only released the reader lock, so the request kept running.
  Each turn's request now has its own AbortController, aborted on exit, and an
  unfinished response body is cancelled before the lock is released.

runScenario is exported with its CLI settings passed in, and main() runs only
when the file is the entry point, so an offline Vitest suite can exercise the
real function: failed turns settle before returning, the native early exit
aborts and cancels, a concurrent action rejection is not unhandled, and the
success path keeps one Pi request per turn, messageId grouping, directorState
carry-over and score:null on scorer failure.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(eval): run the answering and answer-content evals on Pi; retire premature-end

Both evals drove the legacy single-step director prompt and agent prompt,
which #1814 retires. Run them on the real Pi director in process instead
(eval/orchestration/pi-harness.ts): the Pi config helpers supply agent
configs and budgets, whiteboard tools are on as for classroom requests,
thinking is off, and the legacy child runtime is pinned. The harness skips
the HTTP route, so route authorization and tool-capability checks are not
exercised.

- answering classifies by the first recorded call_agent attempt in the
  director tool trace: TEACHER, OTHER_AGENT (another or a non-existent agent),
  NO_DISPATCH (none recorded; wrong, kept in the denominator), or ERROR (a
  failed run, excluded as before). A later recorded attempt never rescues
  the first.
- answer-content judges the full reply of the first recorded teacher attempt.
  A failed run, no recorded teacher attempt, or a first one that is skipped,
  marked isError or empty scores 0. The judge, opening window, threshold and
  all-samples denominator are unchanged. Pi's short teacher replies make the
  two metrics nearly coincide, and the score includes routing.
- Both score only what the trace records. A schema-rejected attempt is not
  recorded, so a later one can score, and a legacy child's partial text after
  a provider failure is judged. Scores can be overstated. Real-chain tests
  (real Pi loop and agent SDK, scripted StreamFn) pin both limits.
- The old prompt A/B variants are removed; results are a Pi baseline.
- premature-end is retired: its single END decision has no Pi counterpart,
  and the close gate does not show a question was answered.
- The three remaining eval scripts load with tsx --conditions=import, so
  ESM-only dependencies resolve.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(chat): always run classroom chat on Pi and fail builds that still opt out

The classroom chat hook, the /api/chat/pi route and PlaybackChromeRoot no
longer read NEXT_PUBLIC_PI_CHAT_ENABLED. The hook sends every turn through
the existing Pi single-request path; the frontend no longer calls the legacy
/api/chat loop (fetchStatelessChat and the runAgentLoop tail are removed).
The Pi branch itself is unchanged apart from indentation.

isPiChatEnabled and its readDefaultOnBoolean helper are removed. The
independent courseware-reference gate stays default-off.

next.config.ts now exports a phase function. In the production-build phase
it fails when NEXT_PUBLIC_PI_CHAT_ENABLED is set to anything other than '',
'true' or '1' (exact match), which covers every value that used to select
the legacy runtime. The error names the value and points to the Classroom
model setting, the google native preset for Gemini, and the administrator
for managed configurations. Other phases do not check the flag. The fixed
env pin for the flag is removed.

This is an intermediate step of #1814 PR 3: the legacy route, director graph
and agent loop are still present and are removed in a follow-up commit, and
Docker/Compose wiring and docs still describe the old rollback.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* refactor(chat): remove the legacy director-graph classroom chat backend

The frontend has run every classroom turn on /api/chat/pi since the previous
commit, so nothing reaches the legacy stack any more. Remove it:

- app/api/chat/route.ts (no stub, redirect or 410; /api/chat/pi stays)
- lib/orchestration/{stateless-generate,director-graph,ai-sdk-adapter,
  director-prompt,prompt-builder}.ts and lib/chat/agent-loop.ts
- summarizers/{conversation-summary,message-converter}.ts
- the director, agent-system and agent-system-wb-* templates, the
  speech-guidelines and whiteboard-reference snippets, and their prompt and
  snippet IDs

Pi's default legacy child, the shared structured-output parser, the Pi
tool schemas, the shared summarizers, the registry and the protocol types
are unchanged. Dependency declarations are left for a follow-up commit.

Tests:
- Drop the legacy chat route from the model-authorization tests and the
  coverage matrix. The mixed compatibility cases keep their six and eight
  stage assertions, and the exhaustive resolver call-site scan is unchanged.
  The locked-classroom case now goes through /api/chat/pi.
- Retire chat-route-user-routes (its precedence cases are rebuilt on the Pi
  route in route-model-precedence), the agent-loop async-state test, and the
  conversation-summary test.
- Keep the #511 intent as a history input contract on Pi:
  toHistoryMessages keeps the human challenge as a user turn in order, and
  buildUserPrompt still reports it after a later agent reply.
- Move the role, peer-context and language-directive prompt checks onto
  Pi's buildChildPrompt. Keep the PBL and placeholder-lint template tests and
  the getActionDescriptions LaTeX guard.
- Add middleware cases for POST /api/chat (401 without access, pass-through
  otherwise) and a Playwright spec that expects a plain 404 from the running
  app.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* build(deps): drop the unused @langchain/langgraph dependency

The legacy director graph was its only consumer and was removed in the
previous commit. Remove the root declaration and let pnpm update the
lockfile: @langchain/langgraph and @langchain/langgraph-checkpoint are no
longer installed. @langchain/langgraph-sdk stays (an optional CopilotKit
peer and a direct dependency of @ag-ui/langgraph).

@langchain/core is kept: CopilotKit requires it as a peer and pnpm would
install it anyway. partial-json and jsonrepair are kept for the Pi parser.

The re-resolution also moved vite 8.0.0's postcss from 8.5.15 to 8.5.23
(both were already in the lockfile; Next's postcss is unchanged) and
shortened four eslint-import snapshot keys without changing versions.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* build(docker): keep the Pi chat flag only as an input to the build check

NEXT_PUBLIC_PI_CHAT_ENABLED no longer selects a chat runtime; next.config.ts
only reads it to fail a production build that still opts out of Pi. Keep the
builder ARG and the Compose build-arg forwarding so an explicit false still
reaches that check, and drop the ENV line: build args are already visible to
the builder's RUN steps, and the value has nothing to configure in the image.

Remove the legacy-chat rollback comment and command from docker-compose.yml
and replace the rollback section of .env.example with a short note that the
legacy runtime is gone and which values now fail the build.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: describe classroom chat after the legacy runtime removal

- Configuration docs (all six locales): drop the Pi rollback example, the
  advice to rebuild with the flag set to false and the Compose rollback
  command. Say instead that classroom chat always runs on Pi and needs a
  tool-calling Classroom model (google preset for Gemini), that the flag
  should be removed, which exact values a production build still accepts,
  and that the Compose service env_file supplies runtime values only.
- READMEs: drop the LangGraph badge and describe lib/orchestration and the
  Pi director loop as they now are.
- CHANGELOG: add the breaking change (model requirement, the flag, POST
  /api/chat answering 404 after the access gate) and the dependency removal.
- lib/prompts/README.md: point the role and length guidelines at
  lib/chat/pi/prompts.ts, correct which tests check placeholders, use a
  missing snippet in the error example, and start the whiteboard eval server
  with the native child runtime off.
- Remove the two comments that told CI and Playwright to leave the flag
  unset.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(chat): pin the server key on a user-route model; document answering eval limits

- route-model-precedence: when the user route switches the classroom model
  to another provider without a key of its own, assert that the model is
  built with the server key rather than the body's key.
- answering eval: state in the header comment and the generated report that
  a run which throws, is aborted or ends without done is ERROR even after it
  dispatched an agent, that ERROR samples stay out of the correct-rate
  denominator, and what the rate therefore does and does not measure. The
  scoring rules are unchanged.

Refs #1814

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-17 00:26:52 +08:00
6e25625a12 feat(chat): add suggested replies to cue_user (#1379)
* feat(chat): mature learner handoff flow

* refactor(roundtable): embed learner handoff in dialogue

* fix(chat): preserve learner handoffs across server restore

* style(roundtable): clarify learner quick replies

* fix(chat): address durable learner handoff review

* fix(chat): preserve long sessions and learner cue presentation

* feat(chat): limit cue_user to optional string suggestions

* feat(chat): show cue_user suggestions in the learner's reply bubble

Move the quick replies out of the separate chip row and into a
"suggested reply" bubble in the user-bubble slot: same right alignment,
corner and avatar as the real user bubble, but a light dashed outline so
it reads as "you could say". Chips wrap (two visible rows, scrolling
inside the bubble's existing max height, with a fade when more are
below) and truncate long labels with a tooltip. In fullscreen the bubble
sits in the right-hand stack above the dock. The centered "Your turn"
cue is unchanged on normal-width stages; on very narrow stages it yields
its space while suggestions are shown. The roundtable stays 192px.

Drop the hard JSON-schema bounds on cue_user (prompt length, option
count and option length) and keep them in the parameter descriptions,
so an over-limit call is normalized by normalizeCueUserOptions instead
of being rejected during argument validation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-17 00:13:22 +08:00
wyucandClaude Opus 5.5 d128ef67c9 fix(chat): save chats without Web Locks on insecure origins (#1929)
* fix(chat): save chats without Web Locks on insecure origins

On plain HTTP at a non-localhost address (a LAN IP, a Tailscale IP or
MagicDNS name) the page is not a secure context and navigator.locks is
undefined. The chat partition lock still required it for the default
store, so loading chats failed silently and every stage flush threw
ChatStorageLockUnavailableError, retrying with backoff and re-uploading
the document each time.

The rule dates from when the default path also migrated and cleared a
browser database shared across tabs. That migration is gone, and the
isolated write mode already used without a shared mutex gives the same
per-chat last-writer-wins result as the locked path. When Web Locks are
missing, use it and log a one-time notice.

Also include the error name and message when a WebKit stack lists only
frames, and document the HTTP limitation in the deployment guide.

Fixes #1800.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(logger): check for the Name: message header, not a substring

A frame-only stack can contain the message by coincidence (a function
named like it) and every stack contains an empty message.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(deployment): note that deletes win over concurrent edits without Web Locks

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 18:43:23 +08:00
wyuc 797d501367 feat(token-plan): let plans declare web fetch; Kimi Coding Plan takes over web fetch (#1927)
* feat(token-plan): support declared web fetch capabilities

* fix(token-plan): take over implicit builtin fetch defaults

* docs(token-plan): include web fetch in modality descriptions
@openmaic/generation@0.3.21
2026-10-16 16:04:06 +08:00
John Costaandwyuc 9f6c1419ec fix(i18n): resolve the initial locale on the server so SSR and hydration agree (AI-assisted) (#1874)
* fix(i18n): resolve the initial locale once on the server and hydrate with it

The root layout now picks the UI locale from the locale cookie, then
Accept-Language, then defaultLocale, renders <html lang> with it, and hands
the locale and its bundle to I18nProvider. The client starts from that value
instead of re-detecting, so the first client render matches the server HTML.

setLocale persists the choice to the cookie (and localStorage) immediately,
loads the new bundle, and commits the locale to React state only once the
bundle is in, dropping a slower earlier switch. A failed load keeps the
current locale and restores the previous choice; a later attempt loads
again. The provider keeps its useTranslation subscription so loads still
re-render. A choice stored only in localStorage by earlier versions is
carried over to the cookie once.

Fixes #1445
Fixes #1536

* fix(i18n): refresh the locale cookie and localStorage mirror on load

When the locale cookie matches the server's choice, write it again on
mount so Safari's 7-day cap on script-set cookies doesn't expire it, and
so localStorage.locale (still read by PBL) follows the server's choice.

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-16 15:09:21 +08:00
Hahaa909andwyuc e003bd304b fix(generation): reject invalid shape rotations (#1891)
* fix(generation): reject invalid shape rotations

Signed-off-by: jianghh <3232826884@qq.com>

* fix(generation): report non-finite shape rotations

* test(generation): format rotation regression

* fix(generation): skip null generated elements

---------

Signed-off-by: jianghh <3232826884@qq.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-16 15:08:07 +08:00
wyuc f86e1949dd feat(web-fetch): add webFetch capability slot with a provider registry (builtin, Kimi) (#1912)
* feat(web-fetch): add provider registry and capability slot

* fix(web-fetch): protect defaults and unify capability execution

* fix(web-fetch): preserve workspace credentials and reuse proxy agents

* fix(web-fetch): retry transient Kimi transport failures

* feat(settings): show web fetch inside the research station

Draw the web fetch slot as a third line (fetch) of the research station
instead of an unconnected station of its own, and describe it as the
agent's page reader, since course generation itself only searches.

- Offer the implicit built-in reader as the slot's server default, so the
  picker shows the same server-default row as with a configured provider.
- Anchor slot pickers to their station card so an open picker never
  covers the card it belongs to.
- Localize the picker's provider group label in zh-CN and zh-TW.

* test(config): verify shared Kimi search and fetch capabilities
2026-10-16 15:07:37 +08:00
wyuc 941f68816d feat(web-search): add Kimi search with shared chat credentials (opt-in) (#1911)
* feat(web-search): add Kimi search with shared chat credentials

* fix(web-search): require explicit Kimi search opt-in

* fix(web-search): preserve search defaults after Kimi opt-in

* fix(web-search): warn when Kimi opt-in needs a slot assignment
2026-10-16 14:41:19 +08:00
wyucandClaude Opus 5.5 a9da60b3b4 release: v1.2.0 (#1917)
* release: v1.2.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* release: date v1.2.0 2026-10-16 and clarify the cumulative scope

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* release: scope the math-hardening note to the app's render paths

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
v1.2.0
2026-10-16 12:06:06 +08:00
wyucandClaude Opus 5.5 4c0809b6b5 docs: v1.2.0 news, classroom export guide and complete upgrade notes (#1916)
* docs: announce v1.2.0 and add a classroom export guide

- README / README-zh: replace the rc.1 news entry with the 1.2.0 GA entry
  (server-first is stable, classroom export), describe the new export
  formats in the highlights and the export table, point to the model
  authorization docs, and note the render-service upgrade order.
- Getting started (all locales): new "Export a classroom" section covering
  PPTX with placeholder slides or slides only, the Resource Pack, offline
  HTML with or without narration, the ZIP used above 400 MB, the classroom
  ZIP, and opening an exported file on a phone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: complete the 1.2.0 upgrade notes in every locale

- Deployment (all locales): before the first start, list the models of
  providers with server-managed credentials, upgrade the render-service
  together with or before the app, and check the Pi classroom model
  (tool calling, native Gemini preset). The Vercel section no longer
  mentions a README Deploy button that no longer exists; the MP4 section
  notes the render-service upgrade order.
- Configuration (all locales): document the tool_calling_required refusal
  of Pi classroom chat; translate the model authorization section, which
  was still in English in every localized page; add the GLM Image
  provider example missing from ja, zh-tw, ru and ar; fix a broken bold
  span in ja.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: move the 1.2.0 date to 2026-10-16 and scope two statements

- README / README-zh: the v1.2.0 news entry is dated 2026-10-16; the
  model list row applies to providers that select an upstream model.
- Getting started (all locales): offline HTML keeps only the briefing of
  a project-based learning scene; continuing the project needs the
  online classroom and a network connection.
- Deployment (all locales): the model list step applies to providers
  that send a selected model upstream; services without model selection,
  such as Tavily or a document parser, need no list.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: note unbundled assets in the offline HTML export

Getting started (all locales): if the export reports assets it could not
bundle, those parts of interactive scenes still load from the network,
as the README already describes for classroom exports.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: correct the unbundled asset note for offline HTML

The standalone HTML's content security policy blocks remote URLs even
when the device is online, so assets the export could not bundle do not
show in the offline file; they remain available in the online classroom.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-16 11:37:30 +08:00
ecb940c136 fix(pi): reject null storeState.scenes members with 400 (#1821) (#1893)
* fix(pi): reject null members of storeState.scenes (#1821)

A null member of storeState.scenes made POST /api/chat/pi return HTTP 500,
or HTTP 200 followed by a stream error, outside the slide-reference check
from #1752. Reject that shape once on the route, before reference
resolution and model resolution, with the existing INVALID_REQUEST 400.

Closes #1821

* fix(pi): reject every non-object member of storeState.scenes (#1821)

Reject primitives and arrays as well as null/undefined, per review, and
report 'storeState.scenes members must be objects'.

---------

Co-authored-by: Frank-zhu2000 <332350688+Frank-zhu2000@users.noreply.github.com>
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-14 15:10:44 +08:00
Hahaa909andwyuc d063ce6efd docs(generation): document shape rotation semantics [AI-assisted] (#1872)
* docs(generation): document shape rotation semantics

* fix(generation): clarify optional shape rotation examples

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
@openmaic/generation@0.3.20
2026-10-14 14:50:18 +08:00
yipwingtimandwyuc 93cceb3205 feat(settings): warn users before submitting API keys (#1158)
* fix(settings): warn for all rendered credentials / 修复所有凭据输入字段的安全提示

* fix(settings): preserve credential notices after upstream merge

* fix(settings): remove stale credential notice import

* fix(i18n): align credential storage hint translations

* refactor(settings): compact credential storage hint

---------

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-14 14:07:16 +08:00
LING DUANandwyuc b5c83842d3 fix(pi): require Google native for official Gemini compatible route (#1897)
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-14 11:33:30 +08:00
wyuc ec176e84d4 test(renderer): give heavy inline-math typesetting suites room on loaded runners (#1907)
## Summary

The package release gate (`publish-packages.yml` → "Validate release candidate") runs the `@openmaic/*` package suites concurrently. The suites that typeset ~1,000 KaTeX formulas (the inline-math hard-cap cases) take ~0.3–0.4 s each locally but exceed vitest's 5 s default on a loaded runner: the release run for fccbf82c failed twice on `inline math typesetting budget > shows formulas past the hard cap as text`, which blocks publishing `@openmaic/generation@0.3.19`. The same class of test (`tests/slide-renderer/inline-math-elements.test.ts` › "keeps progress through repeated commits with formulas too large to cache") also timed out once in the app unit-test job.

This raises the timeout to 30 s for only the four suites that contain those heavy cases (describe-level `{ timeout: 30_000 }`). No product code changes; test files are not publishable inputs, so no version bump.

## Test plan

- [x] Renderer `test/elements/text/inlineMath.test.tsx` + `test/snapshot/inlineMath.test.tsx` (30 passed)
- [x] `tests/slide-renderer/inline-math-elements.test.ts` (5 passed)
- [x] `pnpm check`, `pnpm lint`, `npx tsc --noEmit`, `node scripts/check-package-version-bumps.mjs origin/main`

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@openmaic/generation@0.3.19
2026-10-13 15:08:14 +08:00
wyucandClaude Opus 5.5 a0e2c0e02b fix: typeset inline math in render-service previews and export it cleanly to PPTX (#1904)
* fix(render-service): typeset inline math in slide previews

Slide prose now stores an inline formula as its LaTeX source
(<span data-inline-math="SRC">SRC</span>) and leaves typesetting to the
renderer. render-service pinned @openmaic/renderer 0.1.4, which predates
that, so a slide preview showed the raw source (for example
"\frac{a}{b}") instead of the formula.

- Bump @openmaic/renderer to 0.1.14 and @openmaic/dsl to 0.11.3. The
  changes in between are additive for this service: SlideCanvas props are
  unchanged, the new dsl exports are math hardening and chart style types,
  and charts still render with the lazily loaded ECharts runtime.
- Call completeInlineMath after mounting the slide. The live renderer
  typesets at most 100 formulas per pass before paint and leaves the rest
  to idle time; a capture needs all of them.
- Ship KaTeX's stylesheet with slide previews. KaTeX HTML needs its CSS and
  math fonts: without them, typeset formulas lose their layout (a/b reads
  "ba"). The preview document is an about:blank page, so each font face is
  inlined as its woff2 data URL. The CSS is read from the KaTeX copy the
  renderer resolves, once per process. This also gives LaTeX elements that
  carry a KaTeX HTML snapshot the styles they were missing.

Tests: the stylesheet inlines every face, and a real Chromium preview of
150 stored formulas, with idle callbacks disabled, typesets all of them in
KaTeX fonts before capture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): write inline formulas to PPTX as their LaTeX source

A stored inline formula (<span data-inline-math="SRC">SRC</span>)
already exports as its source text, since the span's text is the source.
Prose that has not been saved yet still carries the editor's rendered
KaTeX tree, and the PPTX text walk wrote every text node in it: the
MathML text, the TeX annotation and each layout glyph as separate runs,
so E=mc^2 became "E=mc2E=mc^2E=mc2". KaTeX from a PPTX import (only a
TeX annotation, no attribute) came out the same way, and table cells
were written verbatim, tags and character references included.

- Treat an inline formula as one run holding its LaTeX source, with the
  same parse rules as the editor: span[data-inline-math], else span.katex
  with a TeX annotation. The run keeps the surrounding text style.
- Write table cell text as plain text: tags dropped, character
  references decoded (stored cells hold "R&amp;D"), breaks and paragraphs
  as newlines, formulas as their source. Cells without markup are
  unchanged.

Formulas stay LaTeX text, not native equations: inline OMML in a text
run needs PowerPoint's AlternateContent wrapper per text shape, which is
left for a separate change that can be checked in PowerPoint.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(export): keep table cell lines when converting cells for PPTX

The table cell conversion sent any cell containing `&` through the HTML
path, which dropped newlines: plain text "R&D\nSales" exported as one
paragraph "R&DSales" instead of two. It also dropped empty paragraphs, so
<p>A</p><p></p><p>B</p> lost its blank line.

- Only text with a tag or comment takes the HTML path. Plain text has its
  character references decoded and keeps its lines.
- In markup, a newline in the text starts a new line, as the slide
  renderer shows it (it turns cell newlines into line breaks), and so do
  <br> and each paragraph. An empty paragraph is an empty line; a
  paragraph that already ended on a break (a trailing <br>, a nested
  block) adds no further line.

Tests read the paragraphs of each exported table cell from the slide XML.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(slide-renderer): keep the uncacheable inline math test fast on a loaded runner

The app slide renderer's "formulas too large to cache" test typeset six
1,360-character matrices (about 170 KB of markup each) in two elements and
polled wall-clock timers for idle work. On a loaded CI runner it ran past
the 5 s test timeout. Apply the approach the renderer package's own tests
already use, keeping what the test pins:

- Each formula is 40 radicals padded with trailing spaces to 1,900 source
  characters. Six still cross the 4,000-character per-pass budget, and
  each render is still over the typeset cache's 64,000-character
  per-entry limit, now asserted, so every re-typeset stays full price.
- Idle work runs through a stubbed idle queue that the test flushes,
  instead of polling timers.
- The test now also asserts that the first pass leaves formulas for later.

The other tests in the file typeset one short formula each and are
unchanged. Under CPU load (12 busy loops plus 12 concurrent runs on 12
cores) the test takes about 2.0 s, down from about 4.1 s; unloaded,
0.32 s, down from 1.0 s.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-13 14:49:01 +08:00
wyuc fccbf82c24 fix(generation): parse data URLs without regex and cap vision image size (#1902)
## Summary

Large or unsupported images attached to vision requests can crash prompt building or be rejected by the model provider, and a single bad image fails the whole generation step (retries fail the same way).

- **`@openmaic/generation` 0.3.19**: `buildVisionUserContent` no longer runs a regex over the whole data URL. A new exported `parseBase64DataUrl` splits header and payload with plain string ops, so multi-megabyte payloads are never scanned by the regex engine.
- **Vision image cap (app)**: new `prepareVisionImages` (`lib/server/generation/vision-images.ts`) runs right before every vision call — outline, scene content, scene actions, and the PBL evaluator (which receives uploaded submissions).
  - Pass-through only for single-frame, 8-bit sRGB/grayscale png/jpeg/webp/gif whose **base64 payload** is within `MAX_VISION_IMAGE_BASE64_BYTES` (1 MiB — providers measure the encoded payload) and whose longest side is within `MAX_VISION_IMAGE_DIMENSION` (2048 px). Pixels are strictly decoded first so truncated data is caught. http(s) URLs are untouched.
  - Everything else (oversized, animated, CMYK, 16-bit, unsupported formats) is decoded once with sharp (first frame, EXIF-rotated, resized inside 2048, flattened on white, sRGB) and encoded to JPEG, stepping quality down until under the cap.
  - Images that still don't fit or can't be decoded are dropped with a warning; the step continues.
  - Preparation runs where vision images are resolved (outline and scene-content pre-resolution), so the prompt's "[see attached]" placeholders and asset-id mappings only describe images that are actually attached. The PBL evaluator logs when an image submission is evaluated without its image.
  - Processing is sequential to bound peak memory.

Non-goals: no change to material upload/extraction, prompts, or generation logic.

## Test plan

- [x] `pnpm check`, `pnpm lint`, `npx tsc --noEmit`
- [x] `@openmaic/generation` build + typecheck + tests (incl. an 8 MiB payload, malformed and non-base64 data URLs, http passthrough)
- [x] New `tests/generation/vision-images.test.ts` (small untouched, large downscaled under caps, unsupported format converted, undecodable dropped while others kept, http untouched); updated scene-content / retry-boundary / evaluator tests
- [x] Full `pnpm test` (Node 22)
- [x] `node scripts/check-package-version-bumps.mjs origin/main`

🤖 Generated with [Claude Code](https://claude.com/claude-code)
2026-10-13 14:37:39 +08:00
BeAIcoderandwyuc 2d5e3840de fix(tests): make the suite reliable on Windows and newer Node runtimes (#1890)
- tests/ci/publish-openmaic-skill.test.ts: resolve bash the way PATH
  finds it on Windows (/bin/bash elsewhere) and join PATH with
  path.delimiter. All 16 cases failed on Windows before this.
- tests/store/kv-persist.test.ts: dedupe standing-problem reports per
  key; how many recovery attempts elapse inside flushTasks is
  wall-clock, not code.
- tests/workbench/workspace-rail-session-rename.test.ts: wait for the
  row/menu with vi.waitFor(..., { timeout: 30_000 }) and give the suite
  its own 30s budget for the cold dynamic import of the rail.
- tests/lint-llm-entry-guard.test.ts: 120s suite timeout — every case
  runs the real eslint over every guarded path.

The media-orchestrator part of the original change is dropped: upstream
rewrote that suite and removed the fragile microtask-hop waits it
targeted.

No production code, no global config changes, no assertion weakened.

Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-13 13:38:49 +08:00
wyucandClaude Opus 5.5 3c5c02f994 fix(renderer): cancel idle typesetting with its own pair and keep release-gate tests stable (#1901)
* fix(renderer): cancel idle typesetting with the pair that scheduled it

whenIdle checked requestIdleCallback/cancelIdleCallback when scheduling but
read cancelIdleCallback again when cancelling. If the global was removed or
replaced in between (a test stub restored, a polyfill swapped in), unmounting
a text element with pending inline math threw "scope.cancelIdleCallback is not
a function", or handed the handle to an implementation that never issued it.
Capture the request/cancel pair, and setTimeout/clearTimeout for the fallback,
at schedule time and always cancel through the captured function.

Make the inline-math regression tests fast and deterministic on a loaded
runner without dropping what they pin:

- Budget tests use distinct formulas padded with trailing spaces to 1,900
  source characters. The budget counts source characters, so they cross it
  exactly like the old 1,357-character matrices, at a fraction of the
  typesetting cost.
- The uncacheable-render test uses 40 radicals per formula: each render is
  still over the 64,000-character cache entry limit (asserted), several times
  cheaper than a large matrix.
- Idle-time work runs through a stubbed idle queue that the test flushes,
  instead of polling wall-clock timers; a fake-timer test covers the
  setTimeout fallback.
- The snapshot tests replace KaTeX with a trivial typesetter (real
  typesetting is covered by the element tests), use the minimum fixture that
  crosses the per-root cap (2 x 501 formulas), wait for the deferred unmount
  before restoring stubs, and count formulas only within the tree being
  measured.

The [600, 600, 600, 600] measurement in the failed release run was a cascade:
slideToPng timed out, kept running, and its off-screen tree was still in
document.body when the next test counted roots across the whole body. Its
deferred unmount then ran after the idle stubs were restored, which is what
raised the unhandled TypeError.

New tests cancel after cancelIdleCallback is removed or replaced, and after
clearTimeout is replaced; they fail on the previous implementation.

Bump @openmaic/renderer to 0.1.14 so the next publish run releases it
(0.1.13 never reached the registry).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* test(packages): keep release-gate tests stable on a loaded runner

The publish workflow runs every package's tests concurrently on one runner.
Two more checks in that step failed when the suites were run under CPU
contention:

- The macro-safety tests in editor, generation and importer asserted that a
  render takes under 100 ms. On a loaded runner a guarded render can exceed
  that. Raise the ceiling to 1 s: the unguarded nestedDef expansion takes tens
  of seconds, a guarded render a few milliseconds, and the output-size and
  error checks that follow are what show the definitions were dropped.
- Editor tests never unmounted their trees, because Testing Library only
  registers automatic cleanup when the runner exposes a global afterEach.
  React work still queued at the end of a file then ran after jsdom was torn
  down ("window is not defined"). Clean up after each test in the shared
  setup.

Test-only changes; no package version bumps are required.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
@openmaic/editor@0.0.11 @openmaic/renderer@0.1.14
2026-10-13 13:14:40 +08:00
LING DUAN da8c92a4a8 fix(chat): guard Pi classroom tool calling before inference (#1894)
* fix(chat): guard Pi classroom tool calling before inference

* fix(i18n): match Pi model guidance to settings labels
2026-10-13 11:19:04 +08:00
Yizuki_Ameandwyuc d725f19194 ci: cover every app PostgreSQL contract suite (#1867)
Co-authored-by: wyuc <wang-yc24@mails.tsinghua.edu.cn>
2026-10-12 17:37:23 +08:00
DDL 9d2eface53 fix(import): preserve committed document on lost response (AI-assisted) (#1864)
* fix(import): preserve committed document on lost response (AI-assisted)

A rejected save response can arrive after the server has committed the imported aggregate. Do not compensate by deleting the stage, because that turns an unknown write outcome into permanent data loss. Keep disposable local-cache cleanup and cover the response-loss path with a stateful regression test.

* fix(import): verify rejected document saves

Read the new document back when saveDocument rejects. Treat a found document as committed, while confirmed absence and read failures keep the import on the error path without destructive cleanup. Cover all three outcomes in the stateful import test.
2026-10-12 17:14:42 +08:00
wyucandClaude Opus 5.5 7ca6077cdd fix(workbench): refuse oversized material uploads before sending them (#1887)
* fix(workbench): refuse oversized material uploads before sending them

The workbench uploader posted every picked file to /api/materials and only
learned about the size cap from the server's 413. The route does refuse an
oversized declared content-length early, but a reverse proxy that buffers
request bodies (nginx's default) still makes the browser send the whole file
first, so a user picking a 200 MB file waits for the full upload before
being told it is too large. Without such a proxy, the early 413 tends to
surface as a generic network failure instead of the size message.

Read the caps the capabilities endpoint already advertises
(maxDocumentBytes / maxMediaBytes, derived from the upload route's own
limits) and refuse a file over its class cap before any bytes are sent,
with the existing "file too large (limit X)" copy. The caps stay
server-owned, so a deployment that raises them is not blocked by a browser
constant. Discovery is fetched once per page and shared; a failed, invalid
or slow (>5s) read fails open to the server's 413, and once a read has
timed out later uploads do not wait on it again until it answers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(workbench): leave unsupported types to the server's 415

The upload route rejects an unsupported MIME (415) before it applies a size
cap. Only precheck the size of supported types, so an oversized unsupported
file still gets the format error instead of being told to shrink.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 19:33:52 +08:00
wyucandClaude Opus 5.5 153d0846a3 release: v1.2.0-rc.2 (#1885)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
v1.2.0-rc.2
2026-10-11 16:01:29 +08:00
2833c6c036 fix(render): bind render jobs to the requesting owner (#1884)
Each MP4 render job is bound to the immutable owner of the submitting request: the app proxy asserts the owner on submit, poll, cancel and download, and the render-service only finds jobs for that owner (foreign and unknown jobs get the same 404, with no cancellation or artifact lookup). Job operations live under a separate /owner-bound/render namespace, so an instance that predates owner binding answers 404 without running a job handler and mixed old/new pools fail closed; job responses must carry the owner-bound marker. Upgrade the render-service together with or before the app.

Co-authored-by: duanjialing.777 <duanjialing.777@bytedance.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 15:44:08 +08:00
40057fe45f fix(media): stop serving legacy media of deleted courses (#1883)
The classroom media route now checks the course lifecycle before touching the filesystem: a tombstoned course gets the same 404 as a missing file, a lifecycle lookup failure fails closed, and live courses (including legacy media without a course row) are served as before. Successful responses use private, max-age=300, must-revalidate; 416 and errors use private, no-store.

Co-authored-by: duanjialing.777 <duanjialing.777@bytedance.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 15:25:49 +08:00