cotutor 0.1.0 → 0.3.0

package/dist/realtime/preview.d.ts

@@ -0,0 +1,23 @@
+export declare function previewVoice(o: {
+    voice: string;
+    text: string;
+    model?: string;
+    env?: NodeJS.ProcessEnv;
+    endpoint?: string;
+    timeoutMs?: number;
+}): Promise<{
+    wav: Buffer;
+} | {
+    error: string;
+}>;
+/** 试连一次(家长端配百炼、doctor --live):握手到 session.updated 就挂,不出声、不花钱;null = 通,否则是原因(no_auth / connect / timeout / 服务端的话) */
+export declare function probeRealtime(o?: {
+    auth?: {
+        key: string;
+        workspaceId: string;
+    };
+    model?: string;
+    env?: NodeJS.ProcessEnv;
+    endpoint?: string;
+    timeoutMs?: number;
+}): Promise<string | null>;

package/dist/realtime/preview.js

@@ -0,0 +1,38 @@
+/**
+ * 试听嘴的一个音色(工作台音色页「实时的嘴」):真连一次百炼 realtime,让它照念一句(同实时老师的照念指令),收下 24k PCM 包成 wav。
+ * 几分钱一次;调用方按「音色 + 句子」缓存,同一句同一个音色只念一次。
+ */
+import { readCue } from "./cues.js";
+import { wavOfPcm } from "../shared/wav.js";
+import { OUTPUT_RATE, RealtimeSession } from "./bailian.js";
+export async function previewVoice(o) {
+    const chunks = [];
+    let err = '';
+    let done = false;
+    const s = new RealtimeSession({ instructions: '你是一位小学老师。', voice: o.voice, model: o.model, turn: 'manual', env: o.env, endpoint: o.endpoint }, {
+        onAudio: (pcm) => { chunks.push(pcm); },
+        onError: (m) => { err = m; },
+        onResponse: (st) => { if (st === 'done')
+            done = true; },
+    });
+    const why = await s.connect();
+    if (why !== null)
+        return { error: why === 'no_auth' ? '没有百炼的 key 或业务空间 id(DASHSCOPE_API_KEY、DASHSCOPE_WORKSPACE_ID)' : `连不上:${why}` };
+    s.createResponse(readCue([o.text]));
+    const until = Date.now() + (o.timeoutMs ?? 20_000);
+    while (!done && !err && Date.now() < until)
+        await new Promise((r) => setTimeout(r, 50));
+    s.close('preview');
+    if (err)
+        return { error: err };
+    if (!chunks.length)
+        return { error: done ? '没出声' : '超时' };
+    return { wav: wavOfPcm(Buffer.concat(chunks), OUTPUT_RATE) };
+}
+/** 试连一次(家长端配百炼、doctor --live):握手到 session.updated 就挂,不出声、不花钱;null = 通,否则是原因(no_auth / connect / timeout / 服务端的话) */
+export async function probeRealtime(o = {}) {
+    const s = new RealtimeSession({ instructions: '试连。', turn: 'manual', model: o.model, auth: o.auth, env: o.env, endpoint: o.endpoint, timeoutMs: o.timeoutMs }, {});
+    const why = await s.connect();
+    s.close('probe');
+    return why;
+}

package/dist/realtime/prompt.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 实时老师的嘴的系统指令:只放人设与规矩,不放老师文件、activity 的流程——
+ * 2026-10-19 P1 实测:流程放进去它也带不动(看图说话六轮只接话不问),要说的话由应用每次放进 response.instructions(src/realtime/cues.ts)。
+ */
+export declare function mouthInstructions(o: {
+    display: string;
+    kidName: string;
+}): string;

package/dist/realtime/prompt.js

@@ -0,0 +1,13 @@
+/**
+ * 实时老师的嘴的系统指令:只放人设与规矩,不放老师文件、activity 的流程——
+ * 2026-10-19 P1 实测:流程放进去它也带不动(看图说话六轮只接话不问),要说的话由应用每次放进 response.instructions(src/realtime/cues.ts)。
+ */
+export function mouthInstructions(o) {
+    return [
+        `你是这个家的${o.display},对面是一个孩子,叫${o.kidName}。`,
+        '你是用嘴说话的那一位:每一次,我都会告诉你这一次说什么。只照做:接住孩子的话,或者把给你的句子原样说出来。',
+        '不讲新内容,不回答题目,不评对错,不问问题。',
+        '只有一种时候例外:我让你看孩子正在画的画,你照我那一次说的,看着画说一两句、问一句;那时也不讲题、不评对错。',
+        '说话亲切、慢一点,像当面说话;不念标点,不念括号。',
+    ].join('\n');
+}

package/dist/realtime/voices.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 嘴(百炼 realtime,qwen3.8-omni-flash-realtime)认的音色:官方列表 https://www.alibabacloud.com/help/zh/model-studio/omni-voice-list 里
+ * 「Qwen3.8-Omni 系列」那 56 个(2026-10-19 照抄;每个都真连过一次让它说一个字,都出声)。trait 是官方描述的概括,lang 是除外语以外会说的(都另会 28 种外语)。
+ * 旧模型的 Bella、Pip、Chelsie、Ethan 这个模型不认:连接照样连得上,第一次开口才报 InvalidParameter——所以写错的音色要在配置这一头拦(工作台、doctor)。
+ * 工作台音色页「实时的嘴」那一半照这张表列、试听、挑(写进 cotutor.json 的 live.voices)。
+ * 英语老师的讲稿是中文里夹英文(「apple 苹果,banana 香蕉」):2026-10-20 真连(照念 → 转写回字)Serena、Tina、Maia、Liora Mira、Mione、Theo Calm 都念对,
+ * Jennifer、Mia 的中文带英文腔(Jennifer:「腿」成了 tway,「它是什么颜色」没了),trait 里记着。
+ */
+export interface RealtimeVoice {
+    /** session.update 的 voice 参数(大小写、空格照官方) */
+    voice: string;
+    /** 官方的中文名 */
+    name: string;
+    trait: string;
+    lang: string;
+}
+export declare const REALTIME_VOICES: readonly RealtimeVoice[];
+/** 这个模型认不认这个音色(工作台、doctor 拦写错的) */
+export declare function isRealtimeVoice(voice: string): boolean;

package/dist/realtime/voices.js

@@ -0,0 +1,71 @@
+/**
+ * 嘴(百炼 realtime,qwen3.8-omni-flash-realtime)认的音色:官方列表 https://www.alibabacloud.com/help/zh/model-studio/omni-voice-list 里
+ * 「Qwen3.8-Omni 系列」那 56 个(2026-10-19 照抄;每个都真连过一次让它说一个字,都出声)。trait 是官方描述的概括,lang 是除外语以外会说的(都另会 28 种外语)。
+ * 旧模型的 Bella、Pip、Chelsie、Ethan 这个模型不认:连接照样连得上,第一次开口才报 InvalidParameter——所以写错的音色要在配置这一头拦(工作台、doctor)。
+ * 工作台音色页「实时的嘴」那一半照这张表列、试听、挑(写进 cotutor.json 的 live.voices)。
+ * 英语老师的讲稿是中文里夹英文(「apple 苹果,banana 香蕉」):2026-10-20 真连(照念 → 转写回字)Serena、Tina、Maia、Liora Mira、Mione、Theo Calm 都念对,
+ * Jennifer、Mia 的中文带英文腔(Jennifer:「腿」成了 tway,「它是什么颜色」没了),trait 里记着。
+ */
+const v = (voice, name, trait, lang = '普通话') => ({ voice, name, trait, lang });
+export const REALTIME_VOICES = [
+    v('Tina', '甜甜', '甜美温暖,解决问题果断(缺省)'),
+    v('Cindy', '林欣宜', '台湾腔嗲嗲的小姐姐', '台湾口音'),
+    v('Liora Mira', '清欢', '温柔的烟火人间感'),
+    v('Raymond', '林川野', '声音清亮,爱吃外卖的宅男'),
+    v('Zane', '泽恩', '磁性迷人'),
+    v('Katerina', '卡捷琳娜', '御姐音,韵律感强'),
+    v('Ryan', '甜茶', '节奏感强,戏感足'),
+    v('Mia', '舒然', '细腻,生活美学风格的温柔博主;中英夹着说时中文带英文腔'),
+    v('Cici', '绵绵', '邻家妹妹,活泼软糯'),
+    v('Theo Calm', '予安', '沉静,治愈感'),
+    v('Serena', '苏瑶', '温柔小姐姐'),
+    v('Maia', '四月', '知性与温柔'),
+    v('Evan', '江晨', '男大学生,年下奶狗'),
+    v('Qiao', '小乔妹', '表面甜妹,个性十足', '台湾口音'),
+    v('Momo', '茉兔', '撒娇搞怪'),
+    v('Wil', '伟伦', '深圳长大的港台腔小哥哥'),
+    v('Angel', '安琪', '带台式口音,甜美'),
+    v('Li Cassian', '李公公', '话中有留白,善察言观色'),
+    v('Joyner', '阿逗', '搞笑、夸张、接地气'),
+    v('Gold', '金爷', '西海岸黑人说唱歌手风格'),
+    v('Jennifer', '詹妮弗', '电影质感的美语女声;中英夹着说时中文带英文腔(苹果念成 pingguo)'),
+    v('Aiden', '艾登', '精通厨艺的美语大男孩'),
+    v('Mione', '敏儿', '成熟知性的英国邻家妹妹'),
+    v('Sunny', '晴儿', '甜美的川妹子', '四川话'),
+    v('Dylan', '晓东', '北京胡同长大的少年', '北京话'),
+    v('Eric', '程川', '成都市井男子,跳脱', '四川话'),
+    v('Peter', '李彼得', '天津相声,专业捧哏', '天津话'),
+    v('Joseph Chen', '阿樸伯', '南洋老华侨', '闽南话'),
+    v('Marcus', '秦川', '老陕风格,面宽话短', '陕西话'),
+    v('Li', '老李', '南京话伯伯,爱骂骂咧咧', '南京话'),
+    v('Rocky', '阿强', '幽默风趣,在线陪聊', '粤语'),
+    v('Kiki', '阿清', '甜美的港妹闺蜜', '粤语'),
+    v('Sohee', '素熙', '温柔开朗的韩国欧尼'),
+    v('Eliška', '艾莉卡', '中欧风格'),
+    v('Alek', '阿列克', '战斗民族的冷与暖'),
+    v('Arda', '阿尔达', '干净利落,温润'),
+    v('Dolce', '多尔切', '慵懒的意大利大叔'),
+    v('Lenn', '莱恩', '德国青年,理性中带叛逆'),
+    v('Ono Anna', '小野杏', '鬼灵精怪的青梅竹马'),
+    v('Sonrisa', '索尼莎', '热情开朗的拉美大姐'),
+    v('Bodega', '博德加', '热情的西班牙大叔'),
+    v('Andre', '安德雷', '磁性、沉稳的男生'),
+    v('Radio Gol', '拉迪奥·戈尔', '足球解说风格'),
+    v('Rizky', '阿力', '印尼青年,声线个性'),
+    v('Roya', '萝雅', '热爱运动的女孩'),
+    v('Hana', '阿幸', '越南成熟姐姐'),
+    v('Jakub', '雅克', '波兰文艺青年,声线磁性'),
+    v('Griet', '海娜', '荷兰成熟文艺女性'),
+    v('Marina', '玛丽娜', '多元文化城市长大的女孩'),
+    v('Siiri', '西芮', '内敛温柔,语速舒缓'),
+    v('Ingrid', '林恩', '挪威乡村姑娘'),
+    v('Sigga', '海娜', '冰岛小镇知性女青年'),
+    v('Bea', '雅娜', '爱喝咖啡的甜美姐姐'),
+    v('Chloe', '思怡', '马来西亚白领女生'),
+    v('Emilien', '埃米尔安', '浪漫的法国大哥哥'),
+    v('longanlingxin', '龙安灵心', '知心温暖音'),
+];
+/** 这个模型认不认这个音色(工作台、doctor 拦写错的) */
+export function isRealtimeVoice(voice) {
+    return REALTIME_VOICES.some((x) => x.voice === voice);
+}

package/dist/runtime/activities.d.ts

@@ -0,0 +1,17 @@
+import type { ActivityRun } from '../schema/index.ts';
+export declare const ACTIVITIES_DIR = "activities";
+export interface ActivityRef {
+    tutor: string;
+    name: string;
+    /** 文件的绝对路径 */
+    file: string;
+}
+/** 例子文件(cotutor activity eval 用):和 activity 放在一起,`<名>.例子.md`;跟着 activity 一起出厂,检查时不当 activity */
+export declare const EXAMPLES_SUFFIX = ".\u4F8B\u5B50";
+/** 某个根下(包的 agents/,或 workspace 的 agents/)每位老师的 activities/*.md;examples = 连例子文件一起(出厂、升级用) */
+export declare function listActivities(agentsDir: string, tutor?: string, opts?: {
+    examples?: boolean;
+}): Promise<ActivityRef[]>;
+/** workspace 里那份的位置 */
+export declare function activityFile(root: string, tutor: string, name: string): string;
+export declare function activityRunFor(root: string, tutor: string, name: string, raw?: string): Promise<ActivityRun>;

package/dist/runtime/activities.js

@@ -0,0 +1,46 @@
+/**
+ * 读 activity 文件(从 app/cli/activities.ts 拆出来,2026-10-29,行为不变):在哪、每位老师有哪几个、按「名=值」的参数拼成一次跑。
+ * 运行层每轮都要读,所以不放在命令行那一层;装、升级、还原、检查仍在 app/cli/activities.ts。
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parseActivity, resolveParams } from "./activity.js";
+import { UsageError } from "../shared/errors.js";
+export const ACTIVITIES_DIR = 'activities';
+/** 例子文件(cotutor activity eval 用):和 activity 放在一起,`<名>.例子.md`;跟着 activity 一起出厂,检查时不当 activity */
+export const EXAMPLES_SUFFIX = '.例子';
+/** 某个根下(包的 agents/,或 workspace 的 agents/)每位老师的 activities/*.md;examples = 连例子文件一起(出厂、升级用) */
+export async function listActivities(agentsDir, tutor, opts = {}) {
+    const out = [];
+    const tutors = tutor ? [tutor] : (await readdir(agentsDir, { withFileTypes: true }).catch(() => [])).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+    for (const t of tutors) {
+        const dir = join(agentsDir, t, ACTIVITIES_DIR);
+        const files = (await readdir(dir).catch(() => [])).filter((f) => f.endsWith('.md')).sort();
+        for (const f of files)
+            if (opts.examples || !f.slice(0, -3).endsWith(EXAMPLES_SUFFIX))
+                out.push({ tutor: t, name: f.slice(0, -3), file: join(dir, f) });
+    }
+    return out;
+}
+/** workspace 里那份的位置 */
+export function activityFile(root, tutor, name) {
+    return join(root, 'agents', tutor, ACTIVITIES_DIR, `${name}.md`);
+}
+export async function activityRunFor(root, tutor, name, raw = '') {
+    const file = activityFile(root, tutor, name);
+    const text = await readFile(file, 'utf8').catch(() => null);
+    if (text === null)
+        throw new UsageError(`${file} 不在;cotutor activity check ${tutor} 看这位老师有哪些`);
+    const params = {};
+    for (const pair of raw.split(/[;；]/).map((x) => x.trim()).filter(Boolean)) {
+        // 值可以有几行(口语课的口语单)
+        const m = /^([^=]+)=([\s\S]*)$/.exec(pair);
+        if (!m)
+            throw new UsageError(`--param 写成「名=值」,几个用 ; 隔开,如 --param '词=播种、羞愧;最多画=1'(「${pair}」不对)`);
+        params[m[1].trim()] = m[2].trim();
+    }
+    const r = resolveParams(parseActivity(text).activity, params);
+    if (r.issues.length)
+        throw new UsageError(r.issues.join(';'));
+    return { name, params: r.values };
+}

package/dist/runtime/activity-state.d.ts

@@ -0,0 +1,22 @@
+import type { Workspace } from '../schema/index.ts';
+import { type Activity, type ActivityRun, type ActivityValue, type ConversationMessage } from '../schema/index.ts';
+/** 这个话题是从哪个 activity 起的:话题里第一条带 activity 的消息(只记在第一条);没有 → null */
+export declare function threadActivity(messages: readonly ConversationMessage[], thread: string): ActivityRun | null;
+/** 读 workspace 里那份 activity 文件;不在 → null */
+export declare function readActivity(ws: Workspace, tutor: string, name: string): Promise<Activity | null>;
+/**
+ * 应用算的值,只算 activity 文件「应用算的」里列了的:
+ *   还能画 = 参数「最多画」减这个话题画了的(画好的与在画的),不小于 0;家长没填最多画 = 不限,不写这一项(拦法「还能画」照过)
+ *   缺 = 这个话题最后一张画图卡被哪条拦法拦下了;画了、没被拦、还没有画图卡 → 空
+ */
+export declare function activityState(ws: Workspace, tutor: string, date: string, messages: readonly ConversationMessage[], thread: string, run: ActivityRun, a: Pick<Activity, 'state'>, now?: number): Promise<Record<string, ActivityValue>>;
+/** 这一轮(job)所在话题的 activity 文件「画家收到什么」;不在 activity 话题、文件不在、没有那节 → null(照 cotutor.json 的画风) */
+export declare function paintTool(ws: Workspace, tutor: string, date: string, job: string): Promise<{
+    prompt: string;
+    negative?: string;
+} | null>;
+/**
+ * 画图前的拦:这一轮(job)在 activity 话题里,就照 activity 文件「应用拦的」查;不在 activity 话题、文件不在 → null(照旧画)。
+ * 返回的函数在画图队里现调,同一轮第二张看得到第一张已经在画。
+ */
+export declare function paintGate(ws: Workspace, tutor: string, date: string, job: string, now: () => number): Promise<(() => Promise<string | null>) | null>;

package/dist/runtime/activity-state.js

@@ -0,0 +1,83 @@
+/**
+ * activity 话题里应用算的值与拦法的接线(4.1):读这个话题的 activity 文件、
+ * 数这个话题画了几张、今天还剩几张、上一张为什么没画。纯判断在 src/runtime/activity.ts(gatePasses / failingGate),这里只管读盘。
+ */
+import { readFile } from 'node:fs/promises';
+import { activityFile } from "./activities.js";
+import { failingGate, parseActivity } from "./activity.js";
+import { threads } from "../schema/index.js";
+import {} from "../schema/index.js";
+import { paintRecordAt } from "../scenes/paint/painter.js";
+/** 这个话题是从哪个 activity 起的:话题里第一条带 activity 的消息(只记在第一条);没有 → null */
+export function threadActivity(messages, thread) {
+    const ths = threads(messages);
+    return messages.find((m, i) => ths[i] === thread && m.activity)?.activity ?? null;
+}
+/** 读 workspace 里那份 activity 文件;不在 → null */
+export async function readActivity(ws, tutor, name) {
+    const text = await readFile(activityFile(ws.root, tutor, name), 'utf8').catch(() => null);
+    return text === null ? null : parseActivity(text).activity;
+}
+/** 这个话题里的画图卡,文件顺序:哪一轮第几张 */
+function paintCards(messages, thread) {
+    const ths = threads(messages);
+    return messages.flatMap((m, i) => (ths[i] === thread && m.section ? m.section.cards.flatMap((c, n) => (c.kind === 'paint' ? [{ job: m.job, n }] : [])) : []));
+}
+/**
+ * 应用算的值,只算 activity 文件「应用算的」里列了的:
+ *   还能画 = 参数「最多画」减这个话题画了的(画好的与在画的),不小于 0;家长没填最多画 = 不限,不写这一项(拦法「还能画」照过)
+ *   缺 = 这个话题最后一张画图卡被哪条拦法拦下了;画了、没被拦、还没有画图卡 → 空
+ */
+export async function activityState(ws, tutor, date, messages, thread, run, a, now = Date.now()) {
+    const out = {};
+    const want = new Set(a.state.map((s) => s.name));
+    if (!want.size)
+        return out;
+    const cards = paintCards(messages, thread);
+    const records = await Promise.all(cards.map((c) => paintRecordAt(ws, tutor, date, c.job, c.n, now)));
+    if (want.has('还能画')) {
+        const drawn = records.filter((r) => r?.state === 'done' || r?.state === 'drawing').length;
+        if (typeof run.params.最多画 === 'number')
+            out.还能画 = Math.max(0, run.params.最多画 - drawn);
+    }
+    if (want.has('缺')) {
+        const last = records[records.length - 1];
+        out.缺 = last?.state === 'none' && last.error.startsWith('gate:') ? last.error.slice(5) : '';
+    }
+    return out;
+}
+/** 这一轮(job)所在话题的 activity 文件「画家收到什么」;不在 activity 话题、文件不在、没有那节 → null(照 cotutor.json 的画风) */
+export async function paintTool(ws, tutor, date, job) {
+    const { readIndex } = await import("./journal/store.js");
+    const index = await readIndex(ws, tutor, date);
+    const at = index.messages.findIndex((m) => m.job === job);
+    if (at < 0)
+        return null;
+    const run = threadActivity(index.messages, threads(index.messages)[at]);
+    const t = run ? (await readActivity(ws, tutor, run.name))?.tools.find((x) => x.tool === '画家') : null;
+    return t ? { prompt: t.prompt, ...(t.negative ? { negative: t.negative } : {}) } : null;
+}
+/**
+ * 画图前的拦:这一轮(job)在 activity 话题里,就照 activity 文件「应用拦的」查;不在 activity 话题、文件不在 → null(照旧画)。
+ * 返回的函数在画图队里现调,同一轮第二张看得到第一张已经在画。
+ */
+export async function paintGate(ws, tutor, date, job, now) {
+    const { readIndex } = await import("./journal/store.js");
+    const index = await readIndex(ws, tutor, date);
+    const at = index.messages.findIndex((m) => m.job === job);
+    if (at < 0)
+        return null;
+    const thread = threads(index.messages)[at];
+    const run = threadActivity(index.messages, thread);
+    const a = run ? await readActivity(ws, tutor, run.name) : null;
+    if (!run || !a || !a.gates.length)
+        return null;
+    return async () => {
+        const latest = await readIndex(ws, tutor, date);
+        const ths = threads(latest.messages);
+        const mine = latest.messages.filter((_, i) => ths[i] === thread);
+        // 这一轮还没轮到的卡没有记录,不算;同一轮前面那张已经在画,算
+        const state = await activityState(ws, tutor, date, mine, thread, run, { state: [{ name: '还能画', type: '数', line: 0 }] }, now());
+        return failingGate(a, { thread: mine, job, state });
+    };
+}

package/dist/runtime/activity.d.ts

@@ -0,0 +1,63 @@
+/**
+ * activity 文件的纯函数(形状在 src/schema/activity.ts):
+ * 解析(永不抛,写坏的行变成问题)、检查(带行号,fix = 要改 / note = 提醒)、递给老师的那节(剥注释、按参数与卡裁段)、工具人模板填插槽。不读文件。
+ */
+import { type Activity, type ActivityValue, type ConversationMessage } from '../schema/index.ts';
+export type ActivityIssueLevel = 'fix' | 'note';
+export interface ActivityIssue {
+    /** fix = 要改;note = 提醒 */
+    level: ActivityIssueLevel;
+    text: string;
+    /** 原文行号,1 起 */
+    line?: number;
+}
+export interface ParsedActivity {
+    activity: Activity;
+    /** 写法上的问题(哪行解析不了);对不对得上注册表由 checkActivity 查 */
+    issues: ActivityIssue[];
+}
+/** 解析一份 activity 文件。永不抛:写坏的行进 issues,其余照常解析 */
+export declare function parseActivity(text: string): ParsedActivity;
+export interface CheckOptions {
+    /** 文件名(不带 .md);给了就查 name 和它一样 */
+    fileName?: string;
+    /** 这位老师的卡(cotutor.json tutors.<老师>.cards);不给 = 全部 */
+    tutorCards?: readonly string[];
+}
+/** 这个 activity 的话题里老师有哪些卡:老师的并上 activity 头上的,text 总在 */
+export declare function activityCards(a: Activity, tutorCards?: readonly string[]): string[];
+/** 对注册表查:参数、应用算的、应用拦的、裁段的名字、正文用的卡、插槽、第一句与收 */
+export declare function checkActivity(a: Activity, opts?: CheckOptions): ActivityIssue[];
+/** 解析 + 检查,按行号排 */
+export declare function lintActivity(text: string, opts?: CheckOptions): {
+    activity: Activity;
+    issues: ActivityIssue[];
+};
+/** 填了没有:空字符串、空列表、没给都算没填 */
+export declare function isFilled(v: unknown): boolean;
+/**
+ * 递给老师的那节:剥掉给人看的注释,`{{有 名}}` 按「参数填了」或「这个话题有这种卡」留或去。
+ * 没有「老师怎么带」返回 null。守卫不配对会抛(checkActivity 先报)。
+ */
+export declare function renderTutorSection(a: Activity, opts: {
+    params?: Record<string, unknown>;
+    cards: readonly string[];
+}): string | null;
+/**
+ * 首页按钮下面家长填的参数(原文)→ 按 activity 文件的「家长填的」解析成值:按声明的顺序、补缺省、按类型转。
+ * 写了没有的参数、要填的没填、类型不对,进 issues(一条一句,给首页检查);值里只留解析得了的。
+ */
+export declare function resolveParams(a: Activity, raw: Readonly<Record<string, string>>): {
+    values: Record<string, ActivityValue>;
+    issues: string[];
+};
+/** 拦法要看的:这个话题的消息(文件顺序)、这一轮的 job、应用算好的值 */
+export interface GateInput {
+    thread: readonly Pick<ConversationMessage, 'job' | 'from' | 'action' | 'section'>[];
+    job: string;
+    state: Readonly<Record<string, ActivityValue>>;
+}
+/** 一条拦法过没过(规则名见 ACTIVITY_GATES;不认得的当过,activity check 会报) */
+export declare function gatePasses(rule: string, input: GateInput): boolean;
+/** 按 activity 文件「应用拦的」的顺序,第一条没过的规则名;都过了 → null */
+export declare function failingGate(a: Pick<Activity, 'gates'>, input: GateInput): string | null;