cotutor 0.2.0 → 0.3.0

package/dist/server/runner.js

@@ -1,277 +0,0 @@
-/**
- * 发消息 = 拼上下文包 → 按运行时 spawn / resume → stream-json 落 conversations/<老师>/<日期>.<job>.log → 索引更新
- * (最终文本 → 板书节 section + 讲稿逐句配音 <日期>.<job>.<n>.mp3 + 家长尾巴 parentText + 解析提醒 warnings)。
- * 流式:stdout 经本进程落盘,同时喂 PartialReader 拼当前回复正文 → parseBoard(partial) → 内存里的 partial section
- * (孩子端 pending 条目带着它,卡随围栏闭合逐张出现);讲稿每定稿一句就开始配音,整轮跑完只等没配完的;
- * 点读段等资产在索引写好之后后台接着配(同一条队列),孩子端点到还没好的段用浏览器的声。
- * 「## 转交」自动起目标老师的一轮(from: system,转交单 = 谁转的、why、refs、孩子的话、voice):目标老师不在 / 关着 / 忙 / 场景作业到了 dailyMax
- * 都不起,原因进这条消息的 warnings;起了记 handoffJob。目标老师用自己的 runtime(cotutor.json tutors.<name>.runtime)。
- * 一老师同时只跑一条(老师还在回上一条就 409),跨天自动新开(索引按本地日期分文件,新文件没 session 就不带 --resume)。
- * 进程 cwd 是老师目录 agents/<name>/(《agent层设计.md》拍板)。
- */
-import { spawn } from 'node:child_process';
-import { closeSync, createWriteStream, existsSync, openSync } from 'node:fs';
-import { mkdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { buildContextPack } from "../lib/context-pack.js";
-import { addMessage, applyRun, cardId, changedCards, conversationFiles, jobId, localDate, localMinute } from "../lib/conversation.js";
-import { BUNDLE_ID_RE, cardAssets, describeCard } from "../cards/index.js";
-import { parseBoard } from "../lib/board.js";
-import { deriveKidView, truncateReply } from "../lib/kid-view.js";
-import { createPartialReader } from "../lib/stream.js";
-import { mergeObservations, parseObservations, recentObservations } from "../lib/ledger.js";
-import { isoWeek, parsePlan, planLinesFor } from "../lib/plan.js";
-import { getRuntime, planRun, runtimeUses } from "../lib/run-plan.js";
-import { currentSlot, parseTimetable, slotLabel } from "../lib/timetable.js";
-import { parseTranscript } from "../lib/transcript.js";
-import { resolvePolicy } from "../schema/index.js";
-import { UsageError } from "../cli/workspace.js";
-import { readAgentBody, readCardStates, readIndex, writeIndex } from "./store.js";
-import { DubQueue, LineDubber, dubReply } from "./tts.js";
-export class BusyError extends Error {
-    constructor(tutor, job) {
-        super(`${tutor} 还在回上一条(${job}),等它说完再发`);
-    }
-}
-/** 上下文包的取材:课程表命中的时段 + 本周计划里本老师的行 + 本学科最近观察 */
-export async function gatherContext(ws, tutor, input) {
-    const t = ws.config.tutors[tutor];
-    const policy = resolvePolicy(ws.config, tutor);
-    const pack = { from: input.from, at: localMinute(input.at), focus: input.focus, plan: [], recent: [] };
-    try {
-        const slot = currentSlot(parseTimetable(await readFile(ws.paths.timetable, 'utf8')).entries, input.at);
-        if (slot)
-            pack.slot = slotLabel(slot);
-    }
-    catch {
-        /* 没有课程表:不带 slot */
-    }
-    try {
-        const { plan } = parsePlan(await readFile(join(ws.paths.plans, `${isoWeek(input.at)}.md`), 'utf8'));
-        if (plan && t)
-            pack.plan = planLinesFor(plan, t.display, policy.contextPack.planLines);
-    }
-    catch {
-        /* 没有本周计划,或读不到:上下文包不带 plan */
-    }
-    try {
-        const { rows } = parseObservations(await readFile(ws.files.observations, 'utf8'));
-        pack.recent = recentObservations(mergeObservations(rows), { subject: t?.subject, n: policy.contextPack.recent });
-    }
-    catch {
-        /* 账本还没有 */
-    }
-    return pack;
-}
-export class Runner {
-    active = new Map();
-    /** 还在后台跑的资产生成(测试与关服前 flush) */
-    background = new Set();
-    getWs;
-    opts;
-    constructor(getWs, opts = {}) {
-        this.getWs = getWs;
-        this.opts = opts;
-    }
-    running(tutor) {
-        const a = this.active.get(tutor);
-        return a ? { job: a.job, date: a.date } : null;
-    }
-    /** 等所有后台资产生成完(测试用) */
-    async flush() {
-        while (this.background.size)
-            await Promise.all([...this.background]);
-    }
-    /** 正在回的那条已经出来的板书(流式);没在跑或还没出卡 → null */
-    partial(tutor) {
-        return this.active.get(tutor)?.partial ?? null;
-    }
-    async send(tutor, input) {
-        const ws = this.getWs();
-        const t = ws.config.tutors[tutor];
-        if (!t)
-            throw new UsageError(`没有叫 ${tutor} 的老师;cotutor.json 的 tutors 里有:${Object.keys(ws.config.tutors).join('、')}`);
-        if (!t.enabled)
-            throw new UsageError(`${t.display} 已关闭(cotutor.json tutors.${tutor}.enabled = false),打开再发`);
-        const text = input.text.trim() || (input.action === 'continue' ? '继续' : input.action === 'submit' ? '(交了答案,没说话)' : '');
-        if (!text)
-            throw new UsageError('消息是空的');
-        const busy = this.active.get(tutor);
-        if (busy)
-            throw new BusyError(tutor, busy.job);
-        const now = (this.opts.now ?? (() => new Date()))();
-        const date = localDate(now);
-        const index = await readIndex(ws, tutor, date);
-        const job = jobId(now, index.messages.length + 1);
-        const { runtime } = getRuntime(ws.config, input.runtime ?? t.runtime);
-        const agentBody = runtimeUses(runtime, '{agentBody}') ? await readAgentBody(ws, tutor) : undefined;
-        const pack = await gatherContext(ws, tutor, { from: input.from, at: now, focus: input.focus });
-        const policy = resolvePolicy(ws.config, tutor);
-        if (policy.board === 'off')
-            pack.board = 'off';
-        // 上一轮之后孩子在卡上做的事:逐张 describe 进上下文包,也记进这条消息(家长视图「孩子在板书上做的」)
-        const cards = changedCards(index, await readCardStates(ws, tutor, date)).map((c) => {
-            const card = index.messages.find((m) => m.job === c.job)?.section?.cards[c.n];
-            const id = cardId(c.job, c.n);
-            return { card: id, text: card ? describeCard(card, c.file.state) : JSON.stringify(c.file.state) };
-        });
-        if (cards.length)
-            pack.cards = cards.map((c) => `${c.card} ${c.text}`);
-        const prompt = buildContextPack(pack, text, policy.contextPack);
-        const plan = planRun(ws.config, index, { agent: tutor, prompt, agentBody, runtime: input.runtime ?? t.runtime });
-        const started = addMessage(index, { job, at: pack.at, from: input.from, text, focus: input.focus, ...(input.action ? { action: input.action } : {}), ...(cards.length ? { cards } : {}), result: 'running', artifacts: [], runtime: plan.runtime });
-        await writeIndex(ws, started);
-        const active = { job, date, partial: null, done: Promise.resolve(started) };
-        active.done = this.spawn(ws, tutor, date, job, plan, policy.replyMaxChars, active).finally(() => this.active.delete(tutor));
-        this.active.set(tutor, active);
-        return { tutor, date, job, plan, done: active.done };
-    }
-    /**
-     * 给 scene-maker 的转交,课包 id 要在卡、refs、作业三处一致:refs[0] 不是合法 id 就取这节里场景卡的 bundle;
-     * scenes/<id>.ts 或 bundles/<id>/ 已经有了(老师起名撞了,真跑见过:孩子卡上放了旧课包)就改成 <id>-2、-3…,卡上的 bundle 一起改。
-     */
-    settleBundleId(ws, h, section) {
-        const warnings = [];
-        const fromCard = section?.cards.find((c) => c.kind === 'scene' && typeof c.props.bundle === 'string')?.props.bundle;
-        let id = h.refs.find((r) => BUNDLE_ID_RE.test(r)) ?? fromCard;
-        if (!id)
-            return { handoff: h, section, warnings: ['转交 scene-maker 没给课包 id(refs 里放 id,或正文里放 scene 卡),画图老师会自己起名,孩子端的卡对不上'] };
-        const taken = (x) => existsSync(join(ws.dirs.scenes, `${x}.ts`)) || existsSync(join(ws.dirs.scenes, `${x}.md`)) || existsSync(join(ws.dirs.bundles, x));
-        if (taken(id)) {
-            let n = 2;
-            while (taken(`${id}-${n}`))
-                n++;
-            const fresh = `${id}-${n}`;
-            warnings.push(`课包 id ${id} 已占用,改成 ${fresh}(卡与转交单一起改)`);
-            id = fresh;
-        }
-        const refs = [id, ...h.refs.filter((r) => r !== h.refs.find((x) => BUNDLE_ID_RE.test(x)) && r !== fromCard)];
-        const cards = section?.cards.map((c) => (c.kind === 'scene' && c.props.bundle === fromCard ? { ...c, props: { ...c.props, bundle: id } } : c));
-        return { handoff: { ...h, refs }, section: section && cards ? { ...section, cards } : section, warnings };
-    }
-    /** 转交单:目标老师看到的那条消息(from: system) */
-    static handoffText(ws, from, job, h, kidText) {
-        const t = ws.config.tutors[from];
-        const lines = [`转交自 ${t?.display ?? from}(${from},job ${job}):`, `why: ${h.why ?? ''}`];
-        if (h.refs.length)
-            lines.push(`refs: ${h.refs.join(', ')}`);
-        if (kidText.trim())
-            lines.push(`孩子刚才说的:${kidText.trim()}`);
-        if (t?.voice)
-            lines.push(`voice: ${t.voice}`);
-        return lines.join('\n');
-    }
-    async handoff(ws, from, job, h, kidText) {
-        const target = ws.config.tutors[h.to];
-        if (!target || !target.enabled)
-            return { started: null, warning: `转交没起:${h.to} ${target ? '关着' : '不在 cotutor.json 里'}` };
-        if (h.to === from)
-            return { started: null, warning: '转交没起:转给了自己' };
-        if (h.to === 'scene-maker') {
-            const policy = resolvePolicy(ws.config, h.to);
-            const today = await readIndex(ws, h.to, localDate((this.opts.now ?? (() => new Date()))()));
-            if (today.messages.length >= policy.scenes.dailyMax)
-                return { started: null, warning: `转交没起:场景作业今天已到上限 ${policy.scenes.dailyMax}(policy scenes.dailyMax)` };
-        }
-        try {
-            const r = await this.send(h.to, { from: 'system', text: Runner.handoffText(ws, from, job, h, kidText) });
-            return { started: { tutor: h.to, job: r.job } };
-        }
-        catch (err) {
-            return { started: null, warning: `转交没起:${err instanceof Error ? err.message : String(err)}` };
-        }
-    }
-    async spawn(ws, tutor, date, job, plan, replyMaxChars, active) {
-        const files = conversationFiles(ws.dirs.conversations, tutor, date);
-        const cwd = join(ws.dirs.agents, tutor);
-        await mkdir(cwd, { recursive: true });
-        const out = createWriteStream(files.log(job));
-        const err = openSync(files.err(job), 'w');
-        const voice = ws.config.tutors[tutor]?.voice;
-        const queue = voice ? new DubQueue(ws.config.tts, voice, files.err(job), this.opts.env) : null;
-        const dubber = queue ? new LineDubber(queue, (n) => files.lineAudio(job, n)) : null;
-        // 流式:stdout 的每一块先落盘再喂读取器;正文变了就(节流 150ms)重解析成 partial 板书,定稿的句子交去配音
-        const reader = createPartialReader();
-        let dirty = false;
-        let timer = null;
-        const reparse = () => {
-            timer = null;
-            if (!dirty)
-                return;
-            dirty = false;
-            const { section } = parseBoard(reader.text(), { partial: true });
-            const lines = section.lines.map((l) => ({ ...l, text: truncateReply(l.text, replyMaxChars).text }));
-            active.partial = section.cards.length || lines.length ? { cards: section.cards, lines, partial: true } : null;
-            if (dubber)
-                lines.forEach((l, i) => dubber.add(i, l.text));
-        };
-        const exit = await new Promise((resolveExit) => {
-            const child = spawn(plan.argv[0], plan.argv.slice(1), {
-                cwd,
-                env: { ...(this.opts.env ?? process.env), COTUTOR_WORKSPACE: ws.root },
-                stdio: ['ignore', 'pipe', err],
-            });
-            child.stdout?.on('data', (chunk) => {
-                out.write(chunk);
-                if (reader.feed(chunk.toString('utf8'))) {
-                    dirty = true;
-                    if (!timer)
-                        timer = setTimeout(reparse, 150);
-                }
-            });
-            child.once('error', (e) => resolveExit({ code: null, spawnError: e }));
-            child.once('close', (code) => resolveExit({ code }));
-        });
-        if (timer)
-            clearTimeout(timer);
-        await new Promise((r) => out.end(r));
-        closeSync(err);
-        if (exit.spawnError) {
-            const { appendFile } = await import('node:fs/promises');
-            await appendFile(files.err(job), `cotutor: 起不来 ${plan.argv[0]}:${exit.spawnError.message}\n`);
-        }
-        const transcript = parseTranscript(await readFile(files.log(job), 'utf8').catch(() => ''));
-        if (!transcript.final) {
-            // 进程退了但没有 result 事件:起不来、被杀、或 CLI 崩了;标 error,原因指向 err.log
-            transcript.final = { text: null, ok: false, reason: exit.spawnError ? `spawn:${exit.spawnError.message}` : `exit:${exit.code ?? 'signal'}` };
-            transcript.items.push({ kind: 'done', text: `本轮没有收尾(${transcript.final.reason}),看 ${date}.${job}.err.log` });
-        }
-        const kidView = deriveKidView(transcript, { replyMaxChars });
-        // 配音:老师配了音色才合成;失败不响,孩子端用浏览器的声。
-        // 有板书讲稿就逐句配(流式时大多已在路上,这里只等没配完的);没有讲稿只有一段话(老形状)才整段配。
-        let audio = null;
-        if (dubber && voice && kidView.section?.lines.length) {
-            const names = await dubber.finish(kidView.section.lines);
-            kidView.section.lines.forEach((l, i) => { l.audio = names[i]; });
-        }
-        else if (voice && kidView.kidText)
-            audio = await dubReply(ws.config.tts, kidView.kidText, voice, { audio: files.audio(job), err: files.err(job) }, this.opts.env);
-        // 重新读索引再并入:跑的这段时间里别的字段(比如家长改了别的)不被旧对象盖掉
-        const latest = await readIndex(ws, tutor, date);
-        let next = applyRun(latest, job, { transcript, kidView, runtime: plan.runtime, audio });
-        // 转交:自动起目标老师的一轮;起不了的原因记进 warnings。给 scene-maker 的先把课包 id 理顺(refs 没写对就取卡上的;已占用就改成 -2,卡与 refs 一起改)
-        if (kidView.handoff) {
-            const fixed = kidView.handoff.to === 'scene-maker' ? this.settleBundleId(ws, kidView.handoff, kidView.section) : { handoff: kidView.handoff, section: kidView.section, warnings: [] };
-            const r = await this.handoff(ws, tutor, job, fixed.handoff, latest.messages.find((m) => m.job === job)?.text ?? '');
-            const warns = [...fixed.warnings, ...(r.warning ? [r.warning] : [])];
-            next = { ...next, messages: next.messages.map((m) => (m.job === job ? { ...m, handoff: fixed.handoff, section: fixed.section, handoffJob: r.started, ...(warns.length ? { warnings: [...(m.warnings ?? []), ...warns] } : {}) } : m)) };
-        }
-        await writeIndex(ws, next);
-        // 资产:点读段逐段配音到 .cards/<n>/<k>.mp3,后台跑,不拦着这一轮收尾;孩子端每次拉 today 都会看到新生成好的
-        if (queue && kidView.section) {
-            const jobs = [];
-            kidView.section.cards.forEach((card, n) => {
-                const list = cardAssets(card);
-                if (!list.length)
-                    return;
-                jobs.push(mkdir(files.cardAssetsDir(job, n), { recursive: true }).then(() => Promise.all(list.map((a) => queue.add(files.cardAsset(job, n, a.file), a.text, `第 ${n + 1} 张卡的 ${a.file} `)))));
-            });
-            if (jobs.length) {
-                const bg = Promise.all(jobs).then(() => undefined, () => undefined);
-                this.background.add(bg);
-                void bg.finally(() => this.background.delete(bg));
-            }
-        }
-        return next;
-    }
-}

package/dist/server/scene-props.d.ts

@@ -1,16 +0,0 @@
-import type { BoardSection } from '../lib/kid-board.ts';
-export interface SceneDirs {
-    bundles: string;
-    /** 截图目录;缩略图路径按它相对 workspace 根算(thumbBase),没有就不给缩略图 */
-    snaps?: string;
-    thumbBase?: string;
-}
-export declare function sceneSnapshot(dirs: SceneDirs, bundle: string): Promise<{
-    title?: string;
-    problem?: string;
-    steps?: string[];
-    ready: boolean;
-    thumb?: string;
-}>;
-/** 一节里的场景卡全部补上快照(别的卡原样) */
-export declare function enrichScenes(dirs: SceneDirs, section: BoardSection): Promise<BoardSection>;

package/dist/server/scene-props.js

@@ -1,39 +0,0 @@
-/**
- * 场景卡下发前的快照:课包在不在、题面、每步讲稿、终帧缩略图——每次 kidDay 现读 bundles/<id>/,不存状态,
- * 所以 scene-maker 作业落地的那一刻,孩子端下一次轮询就看到 ready(卡自己变成可播)。
- */
-import { readFile, stat } from 'node:fs/promises';
-import { join } from 'node:path';
-export async function sceneSnapshot(dirs, bundle) {
-    try {
-        const dir = join(dirs.bundles, bundle);
-        const [scene, manifest] = await Promise.all([readFile(join(dir, 'scene.json'), 'utf8'), readFile(join(dir, 'manifest.json'), 'utf8')]);
-        const s = JSON.parse(scene);
-        const m = JSON.parse(manifest);
-        const steps = (m.steps ?? []).map((x) => (typeof x.line === 'string' ? x.line : ''));
-        let thumb;
-        if (dirs.snaps && dirs.thumbBase !== undefined) {
-            const png = join(dirs.snaps, bundle, `step-${steps.length}.png`);
-            if ((await stat(png).catch(() => null))?.isFile())
-                thumb = `${dirs.thumbBase}/${bundle}/step-${steps.length}.png`;
-        }
-        return { ...(typeof s.title === 'string' ? { title: s.title } : {}), ...(typeof s.problem === 'string' ? { problem: s.problem } : {}), steps, ready: true, ...(thumb ? { thumb } : {}) };
-    }
-    catch {
-        return { ready: false };
-    }
-}
-/** 一节里的场景卡全部补上快照(别的卡原样) */
-export async function enrichScenes(dirs, section) {
-    if (!section.cards.some((c) => c.kind === 'scene'))
-        return section;
-    const cards = [];
-    for (const c of section.cards) {
-        if (c.kind !== 'scene' || typeof c.props.bundle !== 'string') {
-            cards.push(c);
-            continue;
-        }
-        cards.push({ ...c, props: { ...c.props, ...(await sceneSnapshot(dirs, c.props.bundle)) } });
-    }
-    return { ...section, cards };
-}

package/dist/server/store.d.ts

@@ -1,43 +0,0 @@
-import { type CardAssets, type CardStateFile, type CardStates } from '../lib/conversation.ts';
-import { type Transcript } from '../lib/transcript.ts';
-import { type ConversationIndex, type CotutorConfig } from '../schema/index.ts';
-import { type Workspace } from '../cli/workspace.ts';
-export declare class IndexError extends Error {
-    constructor(file: string, cause: string);
-}
-export declare function readIndex(ws: Workspace, tutor: string, date: string): Promise<ConversationIndex>;
-/** 先写 .tmp 再 rename:进程半路死掉不会留下半份索引 */
-export declare function writeIndex(ws: Workspace, index: ConversationIndex): Promise<void>;
-/** 有过对话的日期,新的在前 */
-export declare function listDates(ws: Workspace, tutor: string): Promise<string[]>;
-export declare function readTranscript(ws: Workspace, tutor: string, date: string, job: string): Promise<Transcript | null>;
-/**
- * 一天里卡的目录 <date>.<job>.cards/ 全扫一遍:<n>.json 是孩子做的事(坏文件跳过,孩子端不报),<n>/<k>.mp3 是后台生成好的资产。
- */
-export declare function scanCards(ws: Workspace, tutor: string, date: string): Promise<{
-    states: CardStates;
-    assets: CardAssets;
-}>;
-/** 只要孩子做的事(发消息时挑「上一轮之后改过的」) */
-export declare function readCardStates(ws: Workspace, tutor: string, date: string): Promise<CardStates>;
-/** 存一张卡的状态(先 .tmp 再 rename);turn = 存的时候索引里最后一条的 job */
-export declare function writeCardState(ws: Workspace, tutor: string, date: string, job: string, n: number, file: CardStateFile): Promise<void>;
-/** 画板导出的 png:<date>.<job>.cards/<n>.png;返回相对 conversations/<老师>/ 的名字 */
-export declare function writeCardImage(ws: Workspace, tutor: string, date: string, job: string, n: number, png: Buffer): Promise<string>;
-export declare function readErrLog(ws: Workspace, tutor: string, date: string, job: string): Promise<string>;
-/** 老师文件正文(系统提示),给 {agentBody};从 .claude/agents/ 读,那里的链是必需项 */
-export declare function readAgentBody(ws: Workspace, name: string): Promise<string>;
-/** PATCH 允许改的顶层键(老师团页与设置页);kid / version / 运行时模板走编辑器 */
-export declare const CONFIG_PATCH_KEYS: readonly ["title", "policyDefaults", "tutors", "agents", "paths", "server", "tts"];
-/** 深合并:对象递归、其余覆盖、null 删键(老师条目可整体删:tutors.x = null) */
-export declare function deepMerge(base: unknown, patch: unknown): unknown;
-/**
- * 补丁合到原始 JSON 上(保留 _note 等机器不认识的键),整份过契约再写;写坏了不落盘。
- * 返回新配置;agents 只允许改 default(运行时模板走编辑器,页面上改错一个引号就把老师全弄哑)。
- */
-export declare function patchConfig(ws: Workspace, patch: Record<string, unknown>): Promise<CotutorConfig>;
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export declare function reloadIfChanged(ws: Workspace, lastMtime: number): Promise<{
-    ws: Workspace;
-    mtime: number;
-}>;

package/dist/server/store.js

@@ -1,210 +0,0 @@
-/**
- * 对话与配置的文件层:索引读写(坏索引响亮报错,不静默覆盖)、日期列表、转录读取、老师正文、cotutor.json 补丁写回。
- * 纯函数在 lib/,这里只碰文件系统。
- */
-import { mkdir, readFile, readdir, rename, stat, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { parseAgentFile } from "../lib/agent-file.js";
-import { cardAssetName, conversationFiles, emptyIndex } from "../lib/conversation.js";
-import { parseTranscript } from "../lib/transcript.js";
-import { ConversationIndexSchema, CotutorConfigSchema, DATE_RE, explainIssues, } from "../schema/index.js";
-import { ConfigError, assembleWorkspace, parseConfig, readJson, redactHome } from "../cli/workspace.js";
-export class IndexError extends Error {
-    constructor(file, cause) {
-        super(`对话索引用不了:${redactHome(file)}\n${cause}\n修好它或改名挪开(转录 .log 还在,能重建);不要删。`);
-    }
-}
-export async function readIndex(ws, tutor, date) {
-    const file = conversationFiles(ws.dirs.conversations, tutor, date).index;
-    let text;
-    try {
-        text = await readFile(file, 'utf8');
-    }
-    catch {
-        return emptyIndex(tutor, date);
-    }
-    let raw;
-    try {
-        raw = JSON.parse(text);
-    }
-    catch (err) {
-        throw new IndexError(file, `不是合法 JSON:${err instanceof Error ? err.message : String(err)}`);
-    }
-    const r = ConversationIndexSchema.safeParse(raw);
-    if (!r.success)
-        throw new IndexError(file, explainIssues(r.error.issues).map((l) => `  - ${l}`).join('\n'));
-    return r.data;
-}
-/** 先写 .tmp 再 rename:进程半路死掉不会留下半份索引 */
-export async function writeIndex(ws, index) {
-    const { index: file } = conversationFiles(ws.dirs.conversations, index.tutor, index.date);
-    await mkdir(join(ws.dirs.conversations, index.tutor), { recursive: true });
-    const tmp = `${file}.tmp`;
-    await writeFile(tmp, `${JSON.stringify(index, null, 2)}\n`);
-    await rename(tmp, file);
-}
-/** 有过对话的日期,新的在前 */
-export async function listDates(ws, tutor) {
-    try {
-        return (await readdir(join(ws.dirs.conversations, tutor)))
-            .filter((f) => /^\d{4}-\d{2}-\d{2}\.json$/.test(f))
-            .map((f) => f.slice(0, 10))
-            .filter((d) => DATE_RE.test(d))
-            .sort()
-            .reverse();
-    }
-    catch {
-        return [];
-    }
-}
-export async function readTranscript(ws, tutor, date, job) {
-    try {
-        return parseTranscript(await readFile(conversationFiles(ws.dirs.conversations, tutor, date).log(job), 'utf8'));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 一天里卡的目录 <date>.<job>.cards/ 全扫一遍:<n>.json 是孩子做的事(坏文件跳过,孩子端不报),<n>/<k>.mp3 是后台生成好的资产。
- */
-export async function scanCards(ws, tutor, date) {
-    const dir = join(ws.dirs.conversations, tutor);
-    const states = {};
-    const assets = {};
-    let names;
-    try {
-        names = await readdir(dir);
-    }
-    catch {
-        return { states, assets };
-    }
-    for (const name of names) {
-        const m = new RegExp(`^${date}\\.(\\d{4}-\\d+)\\.cards$`).exec(name);
-        if (!m)
-            continue;
-        const job = m[1];
-        let files;
-        try {
-            files = await readdir(join(dir, name), { withFileTypes: true }).then((es) => es.map((e) => (e.isDirectory() ? `${e.name}/` : e.name)));
-        }
-        catch {
-            continue;
-        }
-        for (const f of files) {
-            const n = /^(\d+)\.json$/.exec(f);
-            if (n) {
-                try {
-                    const raw = JSON.parse(await readFile(join(dir, name, f), 'utf8'));
-                    if (raw && typeof raw.at === 'string' && typeof raw.turn === 'string' && 'state' in raw)
-                        (states[job] ??= {})[Number(n[1])] = raw;
-                }
-                catch {
-                    /* 坏文件:当没做过 */
-                }
-                continue;
-            }
-            const d = /^(\d+)\/$/.exec(f);
-            if (!d)
-                continue;
-            try {
-                const inner = (await readdir(join(dir, name, d[1]))).filter((x) => /^\d+\.mp3$/.test(x)).sort((a, b) => parseInt(a, 10) - parseInt(b, 10));
-                if (inner.length)
-                    (assets[job] ??= {})[Number(d[1])] = inner.map((x) => cardAssetName(date, job, Number(d[1]), x));
-            }
-            catch {
-                /* 目录没了:当没有 */
-            }
-        }
-    }
-    return { states, assets };
-}
-/** 只要孩子做的事(发消息时挑「上一轮之后改过的」) */
-export async function readCardStates(ws, tutor, date) {
-    return (await scanCards(ws, tutor, date)).states;
-}
-/** 存一张卡的状态(先 .tmp 再 rename);turn = 存的时候索引里最后一条的 job */
-export async function writeCardState(ws, tutor, date, job, n, file) {
-    const files = conversationFiles(ws.dirs.conversations, tutor, date);
-    await mkdir(files.cardsDir(job), { recursive: true });
-    const target = files.card(job, n);
-    await writeFile(`${target}.tmp`, `${JSON.stringify(file, null, 2)}\n`);
-    await rename(`${target}.tmp`, target);
-}
-/** 画板导出的 png:<date>.<job>.cards/<n>.png;返回相对 conversations/<老师>/ 的名字 */
-export async function writeCardImage(ws, tutor, date, job, n, png) {
-    const files = conversationFiles(ws.dirs.conversations, tutor, date);
-    await mkdir(files.cardsDir(job), { recursive: true });
-    const target = `${files.cardsDir(job)}/${n}.png`;
-    await writeFile(target, png);
-    return `${date}.${job}.cards/${n}.png`;
-}
-export async function readErrLog(ws, tutor, date, job) {
-    try {
-        return await readFile(conversationFiles(ws.dirs.conversations, tutor, date).err(job), 'utf8');
-    }
-    catch {
-        return '';
-    }
-}
-/** 老师文件正文(系统提示),给 {agentBody};从 .claude/agents/ 读,那里的链是必需项 */
-export async function readAgentBody(ws, name) {
-    for (const dir of [ws.dirs.claudeAgents, ws.dirs.qwenAgents]) {
-        try {
-            return parseAgentFile(await readFile(join(dir, `${name}.md`), 'utf8')).body;
-        }
-        catch {
-            /* 试下一处 */
-        }
-    }
-    throw new ConfigError(join(ws.dirs.claudeAgents, `${name}.md`), '老师文件读不到;cotutor init 补拷');
-}
-/** PATCH 允许改的顶层键(老师团页与设置页);kid / version / 运行时模板走编辑器 */
-export const CONFIG_PATCH_KEYS = ['title', 'policyDefaults', 'tutors', 'agents', 'paths', 'server', 'tts'];
-const isObj = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
-/** 深合并:对象递归、其余覆盖、null 删键(老师条目可整体删:tutors.x = null) */
-export function deepMerge(base, patch) {
-    if (!isObj(base) || !isObj(patch))
-        return patch;
-    const out = { ...base };
-    for (const [k, v] of Object.entries(patch)) {
-        if (v === null)
-            delete out[k];
-        else
-            out[k] = deepMerge(out[k], v);
-    }
-    return out;
-}
-/**
- * 补丁合到原始 JSON 上(保留 _note 等机器不认识的键),整份过契约再写;写坏了不落盘。
- * 返回新配置;agents 只允许改 default(运行时模板走编辑器,页面上改错一个引号就把老师全弄哑)。
- */
-export async function patchConfig(ws, patch) {
-    const unknown = Object.keys(patch).filter((k) => !CONFIG_PATCH_KEYS.includes(k));
-    if (unknown.length)
-        throw new ConfigError(ws.files.config, `页面只能改 ${CONFIG_PATCH_KEYS.join(' / ')},不认识:${unknown.join(', ')};其余字段请直接编辑文件`);
-    if (isObj(patch.agents) && Object.keys(patch.agents).some((k) => k !== 'default')) {
-        throw new ConfigError(ws.files.config, 'agents 只能在页面上改 default;运行时模板请直接编辑文件');
-    }
-    const raw = readJson(ws.files.config);
-    if (raw === null)
-        throw new ConfigError(ws.files.config, '不存在');
-    const merged = deepMerge(raw, patch);
-    const r = CotutorConfigSchema.safeParse(merged);
-    if (!r.success)
-        throw new ConfigError(ws.files.config, `补丁应用后不合契约,未写入:\n${explainIssues(r.error.issues).map((l) => `  - ${l}`).join('\n')}`);
-    const tmp = `${ws.files.config}.tmp`;
-    await writeFile(tmp, `${JSON.stringify(merged, null, 2)}\n`);
-    await rename(tmp, ws.files.config);
-    return r.data;
-}
-/** 文件改了(页面写的、或家长在编辑器改的)就重读;坏了抛 ConfigError,调用方决定是留旧的还是响 */
-export async function reloadIfChanged(ws, lastMtime) {
-    const st = await stat(ws.files.config);
-    if (st.mtimeMs === lastMtime)
-        return { ws, mtime: lastMtime };
-    const raw = readJson(ws.files.config);
-    if (raw === null)
-        throw new ConfigError(ws.files.config, '不存在了');
-    return { ws: assembleWorkspace(ws.root, ws.source, parseConfig(raw, ws.files.config)), mtime: st.mtimeMs };
-}

package/dist/server/tts.d.ts

@@ -1,51 +0,0 @@
-import { type Tts } from '../schema/index.ts';
-export interface TtsResult {
-    /** 成功 → 输出文件路径;失败 → null */
-    file: string | null;
-    error: string | null;
-}
-export declare function synthesize(tts: Tts, vars: {
-    text: string;
-    voice: string;
-    out: string;
-}, opts?: {
-    env?: NodeJS.ProcessEnv;
-    timeoutMs?: number;
-}): Promise<TtsResult>;
-/** 合成一条并把失败原因追加到 err.log;返回文件名(相对 conversations/<老师>/)或 null */
-export declare function dubReply(tts: Tts, text: string, voice: string, files: {
-    audio: string;
-    err: string;
-}, env?: NodeJS.ProcessEnv): Promise<string | null>;
-/**
- * 一轮的配音队列:讲稿句与点读段同一条队,三个并行,先进先出(讲稿句在流式时就进了,自然排在点读段前面)。
- * 每个文件一项;失败写 err.log、结果 null。
- */
-export declare class DubQueue {
-    private readonly queue;
-    private running;
-    private readonly tts;
-    private readonly voice;
-    private readonly err;
-    private readonly env?;
-    constructor(tts: Tts, voice: string, err: string, env?: NodeJS.ProcessEnv);
-    /** 合成 text 到 out;resolve 成文件名(最后一段)或 null;label 是 err.log 里的称呼 */
-    add(out: string, text: string, label: string): Promise<string | null>;
-    private pump;
-}
-/**
- * 边讲边配:流式时讲稿每写完一句就交进来(add),整轮跑完 finish(最终句子)——同下标同文本的直接用,
- * 不一样的(极少:末句被截、partial 与最终切句不同)重配到同一个文件。失败句 null。
- */
-export declare class LineDubber {
-    private readonly jobs;
-    private readonly q;
-    private readonly lineAudio;
-    constructor(q: DubQueue, lineAudio: (n: number) => string);
-    /** 第 i 句(0 起)定稿了;同下标同文本不重配 */
-    add(i: number, text: string): void;
-    /** 最终讲稿:每句拿文件名(已配的直接用,没配的现配) */
-    finish(lines: readonly {
-        text: string;
-    }[]): Promise<(string | null)[]>;
-}