cotutor 0.2.0 → 0.4.0

package/dist/lib/kid-board.d.ts

@@ -1,148 +0,0 @@
-/**
- * 板书(孩子端老师页)的纯逻辑:卡片 JSON 契约、标注锚点、播放状态机、字幕行与输入条的状态。
- * 这份文件两处共用:服务端(解析器、测试)与孩子端页面——kid-page.ts 把它剥掉类型内联进 <script>,
- * 所以**不能有运行时 import、不能碰 DOM、不能用 enum / namespace**(Node 的 stripTypeScriptTypes 只剥类型)。
- *
- * 契约的分工(《板书卡片设计.md》):老师写「段落 = 讲稿,围栏 = 卡」的正文,服务端(src/lib/board.ts + src/cards/)解析成
- * 下面的 BoardSection JSON 放进对话索引;孩子端只认 JSON。卡 = {kind, props},每种卡的 props 契约在 src/cards/<kind>.ts;
- * 这里只知道每种卡「哪些字能被标注、笔是什么样」,不认识的 kind 也有兜底。
- */
-/**
- * 一张卡:kind 是种类(text / read / choice / fill / image / code…),props 由那种卡自己定;state 是孩子在卡上做的事(存服务端,形状由那种卡定);
- * assets 是已经生成好的配音文件(相对 conversations/<老师>/,如 2026-09-10.1620-1.cards/2/1.mp3),点读段按 <段号>.mp3 找
- */
-export interface BoardCard {
-    kind: string;
-    props: Record<string, unknown>;
-    state?: unknown;
-    assets?: string[];
-}
-/** 一处敲黑板:第几张卡上的哪个词 */
-export interface BoardMark {
-    card: number;
-    phrase: string;
-}
-/** 讲到这句时对某张卡做的事(讲稿里 [[名 参数]]):open / close / play… 页面按卡的种类执行,不认识的忽略 */
-export interface BoardCue {
-    card: number;
-    name: string;
-    arg?: string;
-}
-/** 讲稿的一句:配音文件(没有 = 浏览器合成)、这句念到时要画的标注、是不是问句(末句问句 → 停下等)、锚到上一张卡 */
-export interface BoardLine {
-    text: string;
-    audio: string | null;
-    marks: BoardMark[];
-    ask: boolean;
-    /** 这句上面最近的一张卡(没有 = null);播到这句就滚到它,不依赖老师打括号 */
-    anchor: number | null;
-    cues: BoardCue[];
-}
-/** 一节板书 = 一轮回复:卡整块铺,讲稿逐句播;partial = 还在流式生成 */
-export interface BoardSection {
-    cards: BoardCard[];
-    lines: BoardLine[];
-    partial?: boolean;
-}
-/** 一张卡上所有能被标注的文字;不认识的 kind 拿 props 里所有字符串 */
-export declare function cardTexts(card: BoardCard): string[];
-/** 讲稿里方括号的词落到哪张卡:第一张含这个词的卡;找不到的词丢掉(只出字幕,不报错) */
-export declare function anchorMarks(cards: readonly BoardCard[], phrases: readonly string[]): BoardMark[];
-/** 讲稿一句里的 [词] → 词列表;顺序保留 */
-export declare function phrasesIn(line: string): string[];
-/** 去掉讲稿一句里的方括号(念的时候不念括号) */
-export declare function plainLine(line: string): string;
-export type MarkStyle = 'marker' | 'circle' | 'wave' | 'box' | 'green';
-/** 笔的样子按卡定:封面 / 要记住的话 / 点读段涂荧光笔,算式与步骤绿底,选项与填空加框,其余波浪线 */
-export declare function markStyle(card: BoardCard): MarkStyle;
-/** 有舞台交互(能改状态、能「交给老师」)的种类;其余点开只是放大看 */
-export declare function hasState(card: BoardCard): boolean;
-/** 画板上画了几笔(状态里的 ink 元素数) */
-export declare function inkCount(card: BoardCard): number;
-/** 重卡:舞台在 iframe 里的舞台包(/stage/)开,页面只管顶栏、字幕行、输入条 */
-export declare function isHeavy(card: BoardCard): boolean;
-/** 场景卡能不能播(课包到了);没到紧凑态写「图还在路上」 */
-export declare function sceneReady(card: BoardCard): boolean;
-export type ScenePhase = 'loading' | 'ready' | 'drawing' | 'gap' | 'done' | 'paused';
-/** 舞台里场景在播时的字幕行:讲稿句是场景的,右侧按钮映射到播放器(drawing → 暂停;gap / ready / paused → 继续 / 播放;done → 没钮) */
-export declare function sceneSubtitle(phase: ScenePhase, line: string, step: number, total: number): SubtitleView;
-/** 点读第 k 段(0 起)的配音文件(相对 conversations/<老师>/);没生成好 → null(退浏览器合成声) */
-export declare function segmentAudio(card: BoardCard, k: number): string | null;
-/** 填空当前填了什么(按空的顺序;没填的空是空串) */
-export declare function filledAnswers(card: BoardCard): string[];
-/** 孩子在这张卡上做了什么(「交给老师」能不能按、字幕行回显用):选择题是选项,填空是填的字;没做 → [] */
-export declare function stateSummary(card: BoardCard): string[];
-/** 舞台顶栏的名字:文字卡的标题 / 正文、选择题的问题、其余第一段有字的;截 24 字 */
-export declare function cardTitle(card: BoardCard): string;
-/** 选择题:点第 i 项后的选中集合——单选换成它(再点取消),多选切换 */
-export declare function togglePick(picked: readonly number[], i: number, multi: boolean): number[];
-/** 选择题当前选了什么(回显与紧凑态用):「B 三个」 */
-export declare function pickedLabels(card: BoardCard): string[];
-export declare function isQuestion(text: string): boolean;
-/** 孩子端条目里页面用到的字段(与 kid-view 的 KidMessage 兼容) */
-export interface BoardMessage {
-    job: string;
-    question: string | null;
-    reply: string | null;
-    audio: string | null;
-    pending: boolean;
-    section?: BoardSection | null;
-}
-export interface BoardEntry extends BoardSection {
-    job: string;
-    /** 老师还在说:卡只增不改,讲稿不播;整轮跑完换成正式的一节 */
-    partial?: boolean;
-}
-/**
- * 孩子端条目 → 板书节。有 section 用 section(讲稿空就把 reply 当一句);只有 reply 的退成一张文字卡 + 一句讲稿;
- * 孩子的话不上板;还在跑的只有带 partial 板书(流式,已有卡)才出节且标 partial,其余不出。
- */
-export declare function sectionsFromMessages(messages: readonly BoardMessage[]): BoardEntry[];
-/** 一节在目录里的名字:封面标题 > 有名字的文字卡 > 第一张有字的卡 > 第一句讲稿;截到 14 个字 */
-export declare function sectionTitle(s: BoardSection): string;
-/** stage = 讲稿把这句交给了场景卡的舞台([[play]]),等它 done */
-export type PlayStatus = 'idle' | 'playing' | 'paused' | 'waiting' | 'done' | 'stage';
-export interface PlayerState {
-    section: number;
-    line: number;
-    status: PlayStatus;
-}
-/** 打开页面时的位置:停在最后一节末尾;末句是问句就等着(继续钮在) */
-export declare function playerAtEnd(sections: readonly BoardSection[]): PlayerState;
-/** 新来一节:从它第一句开始播;没讲稿就直接算完 */
-export declare function startSection(index: number, sections: readonly BoardSection[]): PlayerState;
-/**
- * 一句播完往下走:同节还有句 → 下一句;没了 → 有下一节就进下一节(孩子已经答过了,不用等);
- * 没下一节且末句是问句 → 停下等;否则完。
- */
-export declare function advance(state: PlayerState, sections: readonly BoardSection[]): PlayerState;
-/** 当前节里播到这句为止该画上的标注(打开页面或跳到某句时一次画齐) */
-export declare function marksUpTo(sections: readonly BoardSection[], state: PlayerState): BoardMark[];
-/** 播到这句该滚到哪张卡:标注所在的卡优先,其次锚点卡,再没有就 null(页面滚到本节第一张) */
-export declare function lineTarget(line: BoardLine): number | null;
-export interface SubtitleInput {
-    state: PlayerState;
-    sections: readonly BoardSection[];
-    /** 孩子刚说的话,短暂回显(拍板 2026-09-10) */
-    echo: string | null;
-    pending: boolean;
-    /** 等老师时那句人设话 */
-    thinking: string;
-    limit: boolean;
-}
-export interface SubtitleView {
-    text: string;
-    kind: 'line' | 'echo' | 'thinking' | 'limit' | 'empty';
-    right: 'pause' | 'play' | 'continue' | 'none';
-}
-/** 字幕行:上限 > 回显孩子的话 > 等老师 > 当前句(按播放状态定右侧的钮) */
-export declare function subtitleFor(i: SubtitleInput): SubtitleView;
-export type BarMode = 'idle' | 'typing' | 'holding';
-export type BarEvent = 'tap' | 'holdStart' | 'holdEnd' | 'holdCancel' | 'sent' | 'blur';
-/** 输入条中间那段:点 → 打字;按住 → 说话;松手 / 上滑取消 / 发出 / 失焦 → 回到闲置 */
-export declare function barNext(mode: BarMode, ev: BarEvent): BarMode;
-export type Layout = 'phone' | 'tablet';
-/** 平板横屏才用两列板书;竖屏与手机一律单列 */
-export declare function layoutFor(width: number, height: number): Layout;
-/** 没配音也没浏览器合成时,一句停多久(毫秒):按字数估 */
-export declare function lineDurationMs(text: string): number;

package/dist/lib/kid-board.js

@@ -1,294 +0,0 @@
-/**
- * 板书(孩子端老师页)的纯逻辑:卡片 JSON 契约、标注锚点、播放状态机、字幕行与输入条的状态。
- * 这份文件两处共用:服务端(解析器、测试)与孩子端页面——kid-page.ts 把它剥掉类型内联进 <script>,
- * 所以**不能有运行时 import、不能碰 DOM、不能用 enum / namespace**(Node 的 stripTypeScriptTypes 只剥类型)。
- *
- * 契约的分工(《板书卡片设计.md》):老师写「段落 = 讲稿,围栏 = 卡」的正文,服务端(src/lib/board.ts + src/cards/)解析成
- * 下面的 BoardSection JSON 放进对话索引;孩子端只认 JSON。卡 = {kind, props},每种卡的 props 契约在 src/cards/<kind>.ts;
- * 这里只知道每种卡「哪些字能被标注、笔是什么样」,不认识的 kind 也有兜底。
- */
-const str = (v) => (typeof v === 'string' ? v : '');
-const strs = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : []);
-/** 一张卡上所有能被标注的文字;不认识的 kind 拿 props 里所有字符串 */
-export function cardTexts(card) {
-    const p = card.props || {};
-    switch (card.kind) {
-        case 'text':
-            return [str(p.title), str(p.text)];
-        case 'read':
-            return strs(p.segments);
-        case 'choice':
-            return [str(p.question), ...strs(p.options)];
-        case 'fill':
-            return [str(p.text)];
-        case 'code':
-            return [str(p.text)];
-        case 'image':
-            return [str(p.caption)];
-        case 'scene':
-            return [str(p.title), str(p.problem), str(p.text)];
-        case 'canvas':
-            return [str(p.prompt)];
-        default:
-            return Object.values(p).flatMap((v) => (typeof v === 'string' ? [v] : strs(v)));
-    }
-}
-/** 讲稿里方括号的词落到哪张卡:第一张含这个词的卡;找不到的词丢掉(只出字幕,不报错) */
-export function anchorMarks(cards, phrases) {
-    const out = [];
-    for (const raw of phrases) {
-        const phrase = raw.trim();
-        if (!phrase)
-            continue;
-        const card = cards.findIndex((c) => cardTexts(c).some((t) => t.includes(phrase)));
-        if (card >= 0)
-            out.push({ card, phrase });
-    }
-    return out;
-}
-/** 讲稿一句里的 [词] → 词列表;顺序保留 */
-export function phrasesIn(line) {
-    const out = [];
-    const re = /\[([^\[\]]+)\]/g;
-    let m;
-    while ((m = re.exec(line)))
-        out.push(m[1]);
-    return out;
-}
-/** 去掉讲稿一句里的方括号(念的时候不念括号) */
-export function plainLine(line) {
-    return line.replace(/\[([^\[\]]+)\]/g, '$1');
-}
-/** 笔的样子按卡定:封面 / 要记住的话 / 点读段涂荧光笔,算式与步骤绿底,选项与填空加框,其余波浪线 */
-export function markStyle(card) {
-    const style = str((card.props || {}).style);
-    switch (card.kind) {
-        case 'text':
-            return style === 'cover' || style === 'note' ? 'marker' : style === 'formula' || style === 'step' ? 'green' : 'wave';
-        case 'read':
-            return 'marker';
-        case 'choice':
-        case 'fill':
-            return 'box';
-        default:
-            return 'wave';
-    }
-}
-/** 有舞台交互(能改状态、能「交给老师」)的种类;其余点开只是放大看 */
-export function hasState(card) {
-    return card.kind === 'choice' || card.kind === 'fill' || card.kind === 'canvas';
-}
-/** 画板上画了几笔(状态里的 ink 元素数) */
-export function inkCount(card) {
-    const st = card.state;
-    return Array.isArray(st?.ink) ? st.ink.length : 0;
-}
-/** 重卡:舞台在 iframe 里的舞台包(/stage/)开,页面只管顶栏、字幕行、输入条 */
-export function isHeavy(card) {
-    return card.kind === 'scene' || card.kind === 'canvas';
-}
-/** 场景卡能不能播(课包到了);没到紧凑态写「图还在路上」 */
-export function sceneReady(card) {
-    return card.kind === 'scene' && (card.props || {}).ready === true;
-}
-/** 舞台里场景在播时的字幕行:讲稿句是场景的,右侧按钮映射到播放器(drawing → 暂停;gap / ready / paused → 继续 / 播放;done → 没钮) */
-export function sceneSubtitle(phase, line, step, total) {
-    switch (phase) {
-        case 'drawing':
-            return { text: line, kind: 'line', right: 'pause' };
-        case 'gap':
-            return { text: line, kind: 'line', right: step >= total ? 'none' : 'continue' };
-        case 'ready':
-            return { text: line, kind: 'line', right: 'play' };
-        case 'paused':
-            return { text: line, kind: 'line', right: 'play' };
-        case 'done':
-            return { text: line, kind: 'line', right: 'none' };
-        default:
-            return { text: '', kind: 'empty', right: 'none' };
-    }
-}
-/** 点读第 k 段(0 起)的配音文件(相对 conversations/<老师>/);没生成好 → null(退浏览器合成声) */
-export function segmentAudio(card, k) {
-    const want = `/${k + 1}.mp3`;
-    return (card.assets || []).find((a) => a.endsWith(want)) ?? null;
-}
-/** 填空当前填了什么(按空的顺序;没填的空是空串) */
-export function filledAnswers(card) {
-    const blanks = typeof (card.props || {}).blanks === 'number' ? card.props.blanks : 0;
-    const st = card.state;
-    const got = Array.isArray(st?.answers) ? st.answers.map((x) => (typeof x === 'string' ? x.trim() : '')) : [];
-    return Array.from({ length: blanks }, (_, i) => got[i] ?? '');
-}
-/** 孩子在这张卡上做了什么(「交给老师」能不能按、字幕行回显用):选择题是选项,填空是填的字;没做 → [] */
-export function stateSummary(card) {
-    if (card.kind === 'choice')
-        return pickedLabels(card);
-    if (card.kind === 'fill')
-        return filledAnswers(card).filter(Boolean);
-    if (card.kind === 'canvas')
-        return inkCount(card) ? [`画了 ${inkCount(card)} 笔`] : [];
-    return [];
-}
-/** 舞台顶栏的名字:文字卡的标题 / 正文、选择题的问题、其余第一段有字的;截 24 字 */
-export function cardTitle(card) {
-    const p = card.props || {};
-    const first = str(p.title) || str(p.question) || str(p.text) || str(p.caption) || str(p.prompt) || strs(p.segments)[0] || cardTexts(card).find((t) => t.trim()) || (card.kind === 'image' ? '图' : card.kind === 'canvas' ? '画一画' : '');
-    const cps = Array.from(first.trim().replace(/\s+/g, ' '));
-    return cps.length > 24 ? `${cps.slice(0, 24).join('')}…` : cps.join('');
-}
-const LETTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-/** 选择题:点第 i 项后的选中集合——单选换成它(再点取消),多选切换 */
-export function togglePick(picked, i, multi) {
-    if (picked.includes(i))
-        return picked.filter((x) => x !== i);
-    return multi ? [...picked, i] : [i];
-}
-/** 选择题当前选了什么(回显与紧凑态用):「B 三个」 */
-export function pickedLabels(card) {
-    const options = strs((card.props || {}).options);
-    const st = card.state;
-    const picked = Array.isArray(st?.picked) ? st.picked.filter((x) => typeof x === 'number') : [];
-    return picked.filter((i) => i >= 0 && i < options.length).map((i) => `${LETTERS[i] ?? i + 1} ${options[i]}`);
-}
-export function isQuestion(text) {
-    const t = text.trim();
-    return t.endsWith('?') || t.endsWith('?');
-}
-function lineFrom(text, audio) {
-    return { text, audio, marks: [], ask: isQuestion(text), anchor: null, cues: [] };
-}
-/**
- * 孩子端条目 → 板书节。有 section 用 section(讲稿空就把 reply 当一句);只有 reply 的退成一张文字卡 + 一句讲稿;
- * 孩子的话不上板;还在跑的只有带 partial 板书(流式,已有卡)才出节且标 partial,其余不出。
- */
-export function sectionsFromMessages(messages) {
-    const out = [];
-    for (const m of messages) {
-        if (m.pending) {
-            if (m.section && m.section.partial && m.section.cards.length)
-                out.push({ job: m.job, cards: m.section.cards, lines: m.section.lines, partial: true });
-            continue;
-        }
-        if (m.section && (m.section.cards.length || m.section.lines.length)) {
-            const lines = m.section.lines.length ? m.section.lines : m.reply ? [lineFrom(m.reply, m.audio)] : [];
-            out.push({ job: m.job, cards: m.section.cards, lines });
-        }
-        else if (m.reply)
-            out.push({ job: m.job, cards: [{ kind: 'text', props: { text: m.reply } }], lines: [lineFrom(m.reply, m.audio)] });
-    }
-    return out;
-}
-/** 一节在目录里的名字:封面标题 > 有名字的文字卡 > 第一张有字的卡 > 第一句讲稿;截到 14 个字 */
-export function sectionTitle(s) {
-    const pick = () => {
-        for (const c of s.cards)
-            if (c.kind === 'text' && c.props.style === 'cover' && str(c.props.title))
-                return str(c.props.title);
-        for (const c of s.cards)
-            if (c.kind === 'text' && str(c.props.title))
-                return str(c.props.title);
-        for (const c of s.cards) {
-            const t = cardTexts(c).find((x) => x.trim());
-            if (t)
-                return t;
-        }
-        return s.lines[0]?.text ?? '';
-    };
-    const cps = Array.from(pick().trim());
-    return cps.length > 14 ? `${cps.slice(0, 14).join('')}…` : cps.join('');
-}
-/** 打开页面时的位置:停在最后一节末尾;末句是问句就等着(继续钮在) */
-export function playerAtEnd(sections) {
-    if (!sections.length)
-        return { section: -1, line: -1, status: 'idle' };
-    const section = sections.length - 1;
-    const line = sections[section].lines.length - 1;
-    const last = sections[section].lines[line];
-    return { section, line, status: last && last.ask ? 'waiting' : 'done' };
-}
-/** 新来一节:从它第一句开始播;没讲稿就直接算完 */
-export function startSection(index, sections) {
-    const s = sections[index];
-    if (!s || !s.lines.length)
-        return { section: index, line: -1, status: 'done' };
-    return { section: index, line: 0, status: 'playing' };
-}
-/**
- * 一句播完往下走:同节还有句 → 下一句;没了 → 有下一节就进下一节(孩子已经答过了,不用等);
- * 没下一节且末句是问句 → 停下等;否则完。
- */
-export function advance(state, sections) {
-    const s = sections[state.section];
-    if (!s)
-        return { ...state, status: 'done' };
-    if (state.line < s.lines.length - 1)
-        return { section: state.section, line: state.line + 1, status: 'playing' };
-    if (state.section < sections.length - 1)
-        return startSection(state.section + 1, sections);
-    const last = s.lines[state.line];
-    return { ...state, status: last && last.ask ? 'waiting' : 'done' };
-}
-/** 当前节里播到这句为止该画上的标注(打开页面或跳到某句时一次画齐) */
-export function marksUpTo(sections, state) {
-    const s = sections[state.section];
-    if (!s || state.line < 0)
-        return [];
-    return s.lines.slice(0, state.line + 1).flatMap((l) => l.marks);
-}
-/** 播到这句该滚到哪张卡:标注所在的卡优先,其次锚点卡,再没有就 null(页面滚到本节第一张) */
-export function lineTarget(line) {
-    if (line.marks.length)
-        return line.marks[line.marks.length - 1].card;
-    return line.anchor;
-}
-/** 字幕行:上限 > 回显孩子的话 > 等老师 > 当前句(按播放状态定右侧的钮) */
-export function subtitleFor(i) {
-    if (i.limit)
-        return { text: '今天聊够啦,明天再来', kind: 'limit', right: 'none' };
-    if (i.echo)
-        return { text: i.echo, kind: 'echo', right: 'none' };
-    if (i.pending)
-        return { text: i.thinking, kind: 'thinking', right: 'none' };
-    const line = i.sections[i.state.section]?.lines[i.state.line];
-    const text = line ? plainLine(line.text) : '';
-    switch (i.state.status) {
-        case 'playing':
-            return { text, kind: 'line', right: 'pause' };
-        case 'paused':
-            return { text, kind: 'line', right: 'play' };
-        case 'waiting':
-            return { text, kind: 'line', right: 'continue' };
-        case 'done':
-            return { text, kind: text ? 'line' : 'empty', right: 'none' };
-        case 'stage':
-            return { text, kind: 'line', right: 'none' };
-        default:
-            return { text: '', kind: 'empty', right: 'none' };
-    }
-}
-/** 输入条中间那段:点 → 打字;按住 → 说话;松手 / 上滑取消 / 发出 / 失焦 → 回到闲置 */
-export function barNext(mode, ev) {
-    switch (ev) {
-        case 'holdStart':
-            return 'holding';
-        case 'holdEnd':
-        case 'holdCancel':
-            return mode === 'holding' ? 'idle' : mode;
-        case 'tap':
-            return mode === 'idle' ? 'typing' : mode;
-        case 'sent':
-        case 'blur':
-            return 'idle';
-        default:
-            return mode;
-    }
-}
-/** 平板横屏才用两列板书;竖屏与手机一律单列 */
-export function layoutFor(width, height) {
-    return width >= 900 && width > height ? 'tablet' : 'phone';
-}
-/** 没配音也没浏览器合成时,一句停多久(毫秒):按字数估 */
-export function lineDurationMs(text) {
-    return Math.max(1200, Array.from(plainLine(text)).length * 260);
-}

package/dist/lib/kid-view.d.ts

@@ -1,63 +0,0 @@
-import type { ConversationMessage, Handoff, HoldupAsk } from '../schema/index.ts';
-import type { CardAssets, CardStates } from './conversation.ts';
-import type { BoardSection } from './kid-board.ts';
-import type { Transcript } from './transcript.ts';
-export interface KidView {
-    /** 给孩子的话(讲稿各句,换行分隔);null = 这次运行没有(出错、还在跑、或最终文本剥完是空的) */
-    kidText: string | null;
-    truncated: boolean;
-    holdup: HoldupAsk | null;
-    handoff: Handoff | null;
-    /** 运行是否正常收尾 */
-    ok: boolean;
-    /** 板书节(卡 + 讲稿);没有卡也没有讲稿 = null */
-    section: BoardSection | null;
-    /** 解析时的提醒(卡没解析成等),家长视图转录里显示 */
-    warnings: string[];
-    /** 第一个 H2 起给家长的尾巴(「## 家长」等);没有 = 空串 */
-    parentText: string;
-}
-/** 以空行分段,取最后一个非空段(段内换行保留) */
-export declare function lastParagraph(text: string): string;
-/** 按码点数截断;能在句末断就在句末断(不加省略号),否则硬截加 … */
-export declare function truncateReply(text: string, max: number): {
-    text: string;
-    truncated: boolean;
-};
-/**
- * 孩子看的正文从哪来(2026-09-10 拍板,两次真跑的教训):`result.result` 只是这轮**最后一段**顶层文本——老师写完板书再用一次工具、再补一句,
- * 板书和「## 转交」段就没了。所以正文 = 这轮里**带围栏(卡)或带 H2 固定段的顶层文本段** + **最后一段**(顺序不变,重复不算两次);
- * 中间那些「我先看看账本」之类没卡没段的话不进。子代理的话本来就不在顶层。
- */
-export declare function kidSource(t: Transcript): string | null;
-export declare function deriveKidView(t: Transcript, policy: {
-    replyMaxChars: number;
-}): KidView;
-/** 孩子端的一条:自己问的话(别人问的不显示)+ 老师给孩子的话 + 配音;出错的运行什么都不出现(问句还在) */
-export interface KidMessage {
-    job: string;
-    at: string;
-    /** 孩子自己说的;家长 / 系统发的不给孩子看,为 null */
-    question: string | null;
-    /** 老师给孩子的话;还在跑或这轮没有 = null */
-    reply: string | null;
-    /** 配音文件名(conversations/<老师>/ 下);没有 = 用浏览器自带的声 */
-    audio: string | null;
-    /** 老师还在想 */
-    pending: boolean;
-    /** 本次运行新增的产物 id */
-    artifacts: string[];
-    /** 板书节(卡 + 讲稿;答案等秘密已剥);没有 = 页面把 reply 当一张文字卡 */
-    section?: BoardSection | null;
-}
-/**
- * 对话索引 → 孩子端条目(《契约草案.md》§4 的机械过滤在服务端做):不带 result / error / holdup / handoff / 费用 / 家长尾巴;
- * 卡上的答案剥掉,孩子自己做的状态(states)与已生成的资产(assets,都从 .cards/ 读)并到卡上。出错的运行:没有 question 的直接不出现;有 question 的只留问句(老师头像不灰,下一条照常)。
- */
-export declare function kidConversation(index: {
-    messages: readonly ConversationMessage[];
-}, states?: CardStates, assets?: CardAssets): KidMessage[];
-/** 今天孩子已发的条数(每日上限按它算;家长发的不算,「继续」不算,交答案算) */
-export declare function kidMessageCount(index: {
-    messages: readonly ConversationMessage[];
-}): number;

package/dist/lib/kid-view.js

@@ -1,93 +0,0 @@
-/**
- * 孩子视图(《cotutor契约草案.md》§4,2026-09-10 改板书):最终文本剥掉「待裁量」「转交」段后,正文就是板书——
- * 普通段落是讲稿(一行一句),围栏是卡(src/lib/board.ts 解析);kidText = 讲稿各句拼起来(家长视图的「孩子看到」摘要),
- * 每句按 replyMaxChars 截;第一个 H2 起是给家长的尾巴(parentText),孩子看不到。出错什么都不出现。机械规则,不靠模型判断。
- * 正文取自 kidSource:带卡 / 带固定段的顶层文本段 + 最后一段(老师板书之后又用了工具也不丢)。
- */
-import { stripSecrets } from "../cards/index.js";
-import { parseBoard } from "./board.js";
-import { parseSections } from "./sections.js";
-const SENTENCE_END = new Set(['。', '!', '!', '?', '?', ';', ';', '\n']);
-/** 以空行分段,取最后一个非空段(段内换行保留) */
-export function lastParagraph(text) {
-    const paras = text
-        .split(/\n[ \t]*\n+/)
-        .map((p) => p.trim())
-        .filter(Boolean);
-    return paras[paras.length - 1] ?? '';
-}
-/** 按码点数截断;能在句末断就在句末断(不加省略号),否则硬截加 … */
-export function truncateReply(text, max) {
-    const cps = Array.from(text);
-    if (cps.length <= max)
-        return { text, truncated: false };
-    let cut = -1;
-    for (let i = Math.min(max, cps.length) - 1; i >= Math.floor(max * 0.4); i--) {
-        if (SENTENCE_END.has(cps[i])) {
-            cut = i + 1;
-            break;
-        }
-    }
-    if (cut > 0)
-        return { text: cps.slice(0, cut).join('').trim(), truncated: true };
-    return { text: `${cps.slice(0, max).join('').trim()}…`, truncated: true };
-}
-const none = (ok, holdup = null, handoff = null) => ({ kidText: null, truncated: false, holdup, handoff, ok, section: null, warnings: [], parentText: '' });
-const FENCE_OR_H2 = /^\s*(?:```|~~~|## )/m;
-/**
- * 孩子看的正文从哪来(2026-09-10 拍板,两次真跑的教训):`result.result` 只是这轮**最后一段**顶层文本——老师写完板书再用一次工具、再补一句,
- * 板书和「## 转交」段就没了。所以正文 = 这轮里**带围栏(卡)或带 H2 固定段的顶层文本段** + **最后一段**(顺序不变,重复不算两次);
- * 中间那些「我先看看账本」之类没卡没段的话不进。子代理的话本来就不在顶层。
- */
-export function kidSource(t) {
-    if (!t.final?.text)
-        return null;
-    const last = t.final.text.trim();
-    const blocks = t.items.filter((i) => i.kind === 'text' && !i.sub).map((i) => i.text.trim());
-    const kept = blocks.filter((b) => b !== last && FENCE_OR_H2.test(b));
-    return [...kept, last].join('\n\n');
-}
-export function deriveKidView(t, policy) {
-    if (!t.final)
-        return none(false);
-    if (!t.final.ok || !t.final.text)
-        return none(t.final.ok);
-    const { body, holdup, handoff } = parseSections(kidSource(t) ?? t.final.text);
-    const board = parseBoard(body);
-    const { cards, lines } = board.section;
-    if (!cards.length && !lines.length)
-        return { ...none(true, holdup, handoff), warnings: board.warnings, parentText: board.tail };
-    let truncated = false;
-    const cut = lines.map((l) => {
-        const r = truncateReply(l.text, policy.replyMaxChars);
-        truncated = truncated || r.truncated;
-        return { ...l, text: r.text };
-    });
-    const section = { ...board.section, lines: cut };
-    const kidText = cut.map((l) => l.text).join('\n');
-    return { kidText: kidText || null, truncated, holdup, handoff, ok: true, section, warnings: board.warnings, parentText: board.tail };
-}
-/**
- * 对话索引 → 孩子端条目(《契约草案.md》§4 的机械过滤在服务端做):不带 result / error / holdup / handoff / 费用 / 家长尾巴;
- * 卡上的答案剥掉,孩子自己做的状态(states)与已生成的资产(assets,都从 .cards/ 读)并到卡上。出错的运行:没有 question 的直接不出现;有 question 的只留问句(老师头像不灰,下一条照常)。
- */
-export function kidConversation(index, states = {}, assets = {}) {
-    const out = [];
-    for (const m of index.messages) {
-        const question = m.from === 'kid' ? m.text : null;
-        const reply = m.result === 'ok' ? (m.kidText ?? null) : null;
-        const pending = m.result === 'running';
-        if (question === null && reply === null && !pending)
-            continue;
-        const per = states[m.job];
-        const files = assets[m.job];
-        const withState = m.section && (per || files) ? { ...m.section, cards: m.section.cards.map((c, n) => ({ ...c, ...(per?.[n] ? { state: per[n].state } : {}), ...(files?.[n]?.length ? { assets: files[n] } : {}) })) } : m.section;
-        const section = m.result === 'ok' && withState ? stripSecrets(withState) : undefined;
-        out.push({ job: m.job, at: m.at, question, reply, audio: reply ? (m.audio ?? null) : null, pending, artifacts: reply ? [...m.artifacts] : [], ...(section ? { section } : {}) });
-    }
-    return out;
-}
-/** 今天孩子已发的条数(每日上限按它算;家长发的不算,「继续」不算,交答案算) */
-export function kidMessageCount(index) {
-    return index.messages.filter((m) => m.from === 'kid' && m.action !== 'continue').length;
-}

package/dist/lib/ledger.d.ts

@@ -1,29 +0,0 @@
-/**
- * 账本读写的纯函数部分:逐行 JSON + zod,坏行报行号不中断;按 id 折叠,后者为准。
- */
-import type { z } from 'zod';
-import { type Artifact, type ArtifactEvent, type Observation, type ObservationLine } from '../schema/index.ts';
-export interface JsonlParse<T> {
-    rows: T[];
-    errors: string[];
-}
-export declare function parseJsonl<T>(text: string, schema: z.ZodType<T>, file?: string): JsonlParse<T>;
-export declare const parseObservations: (text: string) => JsonlParse<ObservationLine>;
-export declare const parseArtifactEvents: (text: string) => JsonlParse<ArtifactEvent>;
-/** 完整行建条目,纠错行改 retracted;顺序按首次出现 */
-export declare function mergeObservations(lines: ObservationLine[]): Observation[];
-/** 折叠产物事件;首行缺 kind / by 的产物报错(不进结果) */
-export declare function mergeArtifacts(events: ArtifactEvent[]): {
-    artifacts: Artifact[];
-    errors: string[];
-};
-/** o-YYYYMMDD-NNN,同日顺延 */
-export declare function nextObservationId(date: string, existing: Iterable<string>): string;
-/** 上下文包的 recent:未撤回、本学科(没配 subject 就全量)的最近 n 条,按日期与出现顺序,只带 date + claim */
-export declare function recentObservations(obs: Observation[], opts: {
-    subject?: string;
-    n: number;
-}): {
-    date: string;
-    claim: string;
-}[];

package/dist/lib/run-plan.d.ts

@@ -1,30 +0,0 @@
-/**
- * 一次运行的命令规划(纯函数):按运行时选 run 还是 resume、填占位符、定 cwd 相对路径。
- * 规则:当天索引里已有会话**且**是同一运行时跑出来的 → resume;否则新开(跨天索引本来就是新的,零点后第一条自然不带 --resume;
- * 换了运行时也新开——claude 的会话 id qwen 不认)。{agentBody} 只给模板里真用到它的运行时读老师正文。
- */
-import { type Runtime, type ConversationIndex, type CotutorConfig } from '../schema/index.ts';
-export interface RunPlan {
-    /** 运行时名(runtimes 里的键) */
-    runtime: string;
-    /** 完整命令行,argv[0] 是可执行文件 */
-    argv: string[];
-    /** 这次是 resume 还是新开 */
-    resume: boolean;
-    /** resume 的会话 id */
-    session: string | null;
-}
-export declare class RuntimeError extends Error {
-}
-export declare function getRuntime(config: CotutorConfig, name?: string): {
-    name: string;
-    runtime: Runtime;
-};
-/** 模板里有没有用到某个占位符(决定要不要去读老师正文) */
-export declare function runtimeUses(runtime: Runtime, placeholder: string): boolean;
-export declare function planRun(config: CotutorConfig, index: Pick<ConversationIndex, 'session'>, vars: {
-    agent: string;
-    prompt: string;
-    agentBody?: string;
-    runtime?: string;
-}): RunPlan;