cotutor 0.1.0 → 0.3.0

package/dist/schema/config.d.ts

@@ -1,100 +1,282 @@
 /**
  * cotutor.json:每个 workspace 一份,一孩一 workspace。承接 drawtell.json 的做法——
- * `paths` 角色映射 + `agents` 的 {run, resume} 命令模板——再加老师表与政策。
- * 字段归属铁律:老师的 .md 文件里只有 name / description / maxTurns / permissionMode / memory + 正文;
- * 人设(display / avatar / voice)、政策、开关全在这里。助教团页只改本文件,永不改链进来的定义文件。
+ * `paths` 角色映射 + `runtimes` 的 {run, resume} 命令模板——再加老师表与政策。
+ * 字段归属铁律:老师的 .md 文件里只有 name / description / maxTurns / permissionMode + 正文;
+ * 人设(display / avatar / voice)、政策、开关全在这里。
  */
 import { z } from 'zod';
-/** 回复形式阶梯(《cotutor产品规划.md》):L0 确定性资源 / L1 口答 / L2 快卡 / L3 补讲 / L4 整包 */
-export declare const REPLY_FORMS: readonly ["L0", "L1", "L2", "L3", "L4"];
-export type ReplyForm = (typeof REPLY_FORMS)[number];
 export declare const PolicySchema: z.ZodObject<{
     replyMaxChars: z.ZodNumber;
-    dailyMessages: z.ZodNumber;
-    dailyRegen: z.ZodNumber;
-    reviewGate: z.ZodBoolean;
-    forms: z.ZodArray<z.ZodEnum<{
-        L0: "L0";
-        L1: "L1";
-        L2: "L2";
-        L3: "L3";
-        L4: "L4";
-    }>>;
     contextPack: z.ZodObject<{
         recent: z.ZodNumber;
         planLines: z.ZodNumber;
+        entryChars: z.ZodNumber;
+    }, z.core.$strip>;
+    effort: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>;
+    tools: z.ZodEnum<{
+        on: "on";
+        off: "off";
+    }>;
+    board: z.ZodEnum<{
+        off: "off";
+        auto: "auto";
+    }>;
+    stall: z.ZodObject<{
+        ms: z.ZodNumber;
+        retries: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type Policy = z.infer<typeof PolicySchema>;
 /** 政策补丁:老师条目与 policyDefaults 都是补丁,逐层盖在 POLICY_DEFAULTS 上 */
 export declare const PolicyPatchSchema: z.ZodObject<{
     replyMaxChars: z.ZodOptional<z.ZodNumber>;
-    dailyMessages: z.ZodOptional<z.ZodNumber>;
-    dailyRegen: z.ZodOptional<z.ZodNumber>;
-    reviewGate: z.ZodOptional<z.ZodBoolean>;
-    forms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-        L0: "L0";
-        L1: "L1";
-        L2: "L2";
-        L3: "L3";
-        L4: "L4";
-    }>>>;
     contextPack: z.ZodOptional<z.ZodObject<{
         recent: z.ZodOptional<z.ZodNumber>;
         planLines: z.ZodOptional<z.ZodNumber>;
+        entryChars: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        on: "on";
+        off: "off";
+    }>>;
+    board: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        auto: "auto";
+    }>>;
+    stall: z.ZodOptional<z.ZodObject<{
+        ms: z.ZodOptional<z.ZodNumber>;
+        retries: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PolicyPatch = z.infer<typeof PolicyPatchSchema>;
-/** 2026-09-08 拍板的缺省:60 字、30 条/日、3 次重生、验收关、上下文包各 10 */
+/** 缺省:60 字、上下文包观察与计划各 10、原文各 4000 字、30 秒没动静算断流 */
 export declare const POLICY_DEFAULTS: Policy;
-/** agent 名:与 .claude/agents/<name>.md 的 frontmatter name 一致,小写字母数字连字符 */
+/** 板书能用的卡(注册表顺序;tests/cards.test.ts 断言与 src/board/cards 的 kindsFor('board') 一致,这里不 import 卡,免得契约拖进卡的依赖) */
+export declare const BOARD_CARD_KINDS: readonly ["text", "read", "choice", "image", "tianzige", "word", "lecture", "canvas", "paint", "photo", "code"];
+export type BoardCardKind = (typeof BOARD_CARD_KINDS)[number];
+/** agent 名:与 agents/<name>.md 的 frontmatter name 一致,小写字母数字连字符 */
 export declare const AGENT_NAME_RE: RegExp;
-export declare const TeacherSchema: z.ZodObject<{
+/** 老师卡上的常驻入口:不经首页发布、一直在那位老师的卡上 */
+export declare const TUTOR_EXTRAS: readonly ["dictation", "talk"];
+export type TutorExtra = (typeof TUTOR_EXTRAS)[number];
+export declare const TutorSchema: z.ZodObject<{
     display: z.ZodString;
     subject: z.ZodOptional<z.ZodString>;
     avatar: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodString>;
     voice: z.ZodOptional<z.ZodString>;
     enabled: z.ZodDefault<z.ZodBoolean>;
     hidden: z.ZodDefault<z.ZodBoolean>;
+    cards: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        text: "text";
+        word: "word";
+        read: "read";
+        choice: "choice";
+        code: "code";
+        image: "image";
+        lecture: "lecture";
+        canvas: "canvas";
+        tianzige: "tianzige";
+        paint: "paint";
+        photo: "photo";
+    }>>>;
     policy: z.ZodOptional<z.ZodObject<{
         replyMaxChars: z.ZodOptional<z.ZodNumber>;
-        dailyMessages: z.ZodOptional<z.ZodNumber>;
-        dailyRegen: z.ZodOptional<z.ZodNumber>;
-        reviewGate: z.ZodOptional<z.ZodBoolean>;
-        forms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            L0: "L0";
-            L1: "L1";
-            L2: "L2";
-            L3: "L3";
-            L4: "L4";
-        }>>>;
         contextPack: z.ZodOptional<z.ZodObject<{
             recent: z.ZodOptional<z.ZodNumber>;
             planLines: z.ZodOptional<z.ZodNumber>;
+            entryChars: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        tools: z.ZodOptional<z.ZodEnum<{
+            on: "on";
+            off: "off";
+        }>>;
+        board: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            auto: "auto";
+        }>>;
+        stall: z.ZodOptional<z.ZodObject<{
+            ms: z.ZodOptional<z.ZodNumber>;
+            retries: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    runtime: z.ZodOptional<z.ZodString>;
+    extras: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        dictation: "dictation";
+        talk: "talk";
+    }>>>;
 }, z.core.$strip>;
-export type Teacher = z.infer<typeof TeacherSchema>;
+export type Tutor = z.infer<typeof TutorSchema>;
+/** 学科的标准名:三门主科的别名归一(语文 / 数学 / 英语),别的原样(去两头空白);没写 null */
+export declare function canonicalSubject(subject: string | null | undefined): string | null;
+/** 这位老师的听写写哪种:学科是英语(含别名)= en(四线三格写英文单词),别的 zh */
+export declare function subjectLang(subject: string | null | undefined): 'zh' | 'en';
+/**
+ * 这位老师卡上的常驻入口:配了照配的;没配按学科——语文 = 听写;英语 = 口语课,要口语课开着(talkOn = talk.enabled)
+ */
+export declare function tutorExtras(t: Pick<Tutor, 'extras' | 'subject'>, talkOn?: boolean): TutorExtra[];
 /**
- * 运行时预设:一个 CLI 一组 {run, resume} 命令模板。占位符:
+ * 运行时:一个 CLI 一组 {run, resume} 命令模板。占位符:
  * {agent} 老师名 / {agentBody} 老师文件正文(给没有 --agent 的 CLI 塞系统提示)/ {prompt} 消息 / {session} 会话 id。
- * 政策旋钮(预算、轮数、模型)写进模板,换 agent 只换预设。
+ * 板书写法的两种预载({boardFile} 板书技能 SKILL.md 的绝对路径,给能从文件追加系统提示的 CLI;{systemBody} 老师正文 + 板书写法,给只收一段系统提示文字的 CLI):
+ * 模板里用了其中一个,应用就当板书写法已在系统提示里;都没用,应用在话题第一条消息里注入 <cotutor-board>(任何 CLI 都成立的退路)。
+ * {effort} 这位老师的政策 effort(low / medium / high),qwen 由适配器写入思考量配置。
+ * 带不带工具由适配器展开(src/brain/cli/):{tools} 填一串工具名,独占一个参数的 {toolArgs} 展开成几个参数。
+ * 政策旋钮(预算、轮数、模型)写进模板,换 agent 只换运行时。
+ * stdin: "stream-json":消息不进命令行,写进 stdin(`--input-format stream-json`),
+ * 模板里就不写 {prompt};argv 与消息无关,应用把下一轮的进程提前起好等着。
  */
-export declare const AgentPresetSchema: z.ZodObject<{
+export declare const CliRuntimeSchema: z.ZodObject<{
+    cli: z.ZodOptional<z.ZodString>;
     run: z.ZodArray<z.ZodString>;
     resume: z.ZodArray<z.ZodString>;
+    stdin: z.ZodOptional<z.ZodLiteral<"stream-json">>;
 }, z.core.$strip>;
-export type AgentPreset = z.infer<typeof AgentPresetSchema>;
-export declare const AgentsSchema: z.ZodObject<{
+export type CliRuntime = z.infer<typeof CliRuntimeSchema>;
+/**
+ * 内置 API 运行时(2026-10-29):应用自己直连模型(src/brain/api.ts),不起 CLI、不用装 Qwen Code。
+ * 现在只有百炼(OpenAI 兼容的 Chat Completions,端点是业务空间 id 的域名);凭证是机器级的百炼配置(家长端「首页」里填的按量 key 与业务空间 id)。
+ * 系统提示 = 老师正文 + 板书写法;同一话题的模型历史由应用存;effort 映射成思考开关与思考量;工具只有只读的三样。
+ */
+export declare const ApiRuntimeSchema: z.ZodObject<{
+    api: z.ZodLiteral<"bailian">;
+    model: z.ZodString;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ApiRuntime = z.infer<typeof ApiRuntimeSchema>;
+export declare const RuntimeSchema: z.ZodUnion<readonly [z.ZodObject<{
+    cli: z.ZodOptional<z.ZodString>;
+    run: z.ZodArray<z.ZodString>;
+    resume: z.ZodArray<z.ZodString>;
+    stdin: z.ZodOptional<z.ZodLiteral<"stream-json">>;
+}, z.core.$strip>, z.ZodObject<{
+    api: z.ZodLiteral<"bailian">;
+    model: z.ZodString;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+export type Runtime = z.infer<typeof RuntimeSchema>;
+export declare const isApiRuntime: (r: Runtime) => r is ApiRuntime;
+export declare const RuntimesSchema: z.ZodObject<{
     default: z.ZodString;
-}, z.core.$catchall<z.ZodObject<{
+}, z.core.$catchall<z.ZodUnion<readonly [z.ZodObject<{
+    cli: z.ZodOptional<z.ZodString>;
     run: z.ZodArray<z.ZodString>;
     resume: z.ZodArray<z.ZodString>;
-}, z.core.$strip>>>;
-/** paths 里 CLI 认识的角色;其余角色原样保留给应用层。vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根 */
-export declare const PATH_ROLES: readonly ["vault", "photos", "diary", "plans", "profile", "timetable"];
+    stdin: z.ZodOptional<z.ZodLiteral<"stream-json">>;
+}, z.core.$strip>, z.ZodObject<{
+    api: z.ZodLiteral<"bailian">;
+    model: z.ZodString;
+    maxSteps: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>>>;
+/**
+ * paths 里 CLI 认识的角色;其余角色原样保留给应用层。vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根;
+ * captures(应用拍的作业照片)是 workspace 侧,相对 workspace 根(《obsidian仓库设计.md》§5:vault 里存文字不存图)。
+ * 缺省是中文名(2026-09-14):vault 是家长在 Obsidian 里看的,目录名要像人写的。
+ */
+export declare const PATH_ROLES: readonly ["vault", "diary", "plans", "profile", "timetable", "textbooks", "reference", "captures"];
 export type PathRole = (typeof PATH_ROLES)[number];
+/** 相对 workspace 根(不是 vault)的角色 */
+export declare const WORKSPACE_ROLES: readonly PathRole[];
 export declare const ROLE_DEFAULTS: Record<PathRole, string>;
+/** vault 的写入政策(《obsidian仓库设计.md》§4):话题打分 ≥ keepScore 才把摘要与骨架沉淀进日记;孩子问的话总是记 */
+export declare const VaultPolicySchema: z.ZodObject<{
+    keepScore: z.ZodDefault<z.ZodNumber>;
+    autoBookkeep: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type VaultPolicy = z.infer<typeof VaultPolicySchema>;
+/**
+ * 口语课:孩子在口语课页拍一张今天学的那页,改好口语单,交给英语老师的实时页上课
+ * (activity「口语课」:先热身、再打电话)。口语课页自己不再打电话。出厂关着;要百炼 key。
+ */
+export declare const TALK_DEFAULT: {
+    enabled: boolean;
+    listModel: string;
+    minutes: number;
+};
+export declare const TalkSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    listModel: z.ZodDefault<z.ZodString>;
+    minutes: z.ZodDefault<z.ZodNumber>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TalkConfig = z.infer<typeof TalkSchema>;
+/**
+ * 实时老师:老师用 realtime 模型开口(嘴),老师 CLI 在后面写板书(脑);讲稿不配音,交给嘴照念。
+ * 有脸的老师都走实时,没有开关;要百炼按量 key 与业务空间 id,没配孩子端打不开。
+ */
+/** 嘴的缺省音色:出厂三位各一个(10-19 起 Ray 那里用着的),别的老师用 MOUTH_VOICE。不进 voices 的缺省值:voices 的键要是在的老师 */
+export declare const MOUTH_VOICE = "Serena";
+export declare const SHIPPED_MOUTHS: Readonly<Record<string, string>>;
+export declare const LIVE_DEFAULT: {
+    model: string;
+    voices: Record<string, string>;
+    listen: "hold";
+    vad: "server_vad";
+    silenceMs: number;
+};
+export declare const LiveSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodString>;
+    voices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    listen: z.ZodDefault<z.ZodEnum<{
+        hold: "hold";
+        open: "open";
+    }>>;
+    vad: z.ZodDefault<z.ZodEnum<{
+        server_vad: "server_vad";
+        semantic_vad: "semantic_vad";
+    }>>;
+    silenceMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type LiveConfig = z.infer<typeof LiveSchema>;
+/** 这位老师的嘴用哪个音色 */
+export declare const mouthVoice: (live: Pick<LiveConfig, "voices">, tutor: string) => string;
+/**
+ * 听写:拍照认词表用哪个模型。挑词的要求在听写 activity 文件「认字收到什么」;
+ * 下面两份是出厂那节的原文,workspace 里没有听写 activity 文件时照它。回什么格式(一行一段 JSON)由应用填(src/scenes/dictation/recognize.ts 的 FORMAT)。
+ */
+export declare const DICTATION_PROMPT_DEFAULT: string[];
+/** 英文单词的拍照认词(英语老师卡上的拍照听写) */
+export declare const DICTATION_PROMPT_EN_DEFAULT: string[];
+export declare const DICTATION_DEFAULT: {
+    model: string;
+};
+export declare const DictationSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type DictationConfig = z.infer<typeof DictationSchema>;
+/**
+ * 你说我画:画图卡(paint)用哪个文生图模型、画多大、画成什么样(一天几张的上限 10-21 去掉了,老配置里的 daily 不认)。
+ * 画风在 activity 文件「画家收到什么」那节;PAINT_PROMPT_DEFAULT 是出厂那节的画风,不在 activity 话题里画照它。版式、角色、分幅由应用接(src/scenes/paint/prompt.ts)。
+ * 2026-10-11 拿「小熊和小猴种西瓜」四格试:qwen-image-2.0 4 秒、qwen-image-2.0-pro 15 秒,四格里角色都对得上;pro 的表情(低头、脸红)更到位。
+ * 2026-10-13 缺省换 qwen-image-3.0-pro:千问 Token Plan 有它(一张约 50 Credits),2.0 系列没有;同一个四格 10 秒,画风照提示词,角色分到哪格有几处没对上。
+ * 2026-10-21「除了圆圈数字」挪进多格的版式:写在画风里一幅的图也收到,宇宙那张散着画了 ①③Ⓐ。
+ */
+export declare const PAINT_PROMPT_DEFAULT: string[];
+/** 反向提示词(百炼限 500 字符):画家不要的;activity 文件「画家收到什么」没写就用它 */
+export declare const PAINT_NEGATIVE = "\u6587\u5B57,\u5B57\u6BCD,\u6C34\u5370,\u5BF9\u8BDD\u6C14\u6CE1,\u62DF\u58F0\u8BCD,\u5199\u5B9E\u7167\u7247,\u6050\u6016,\u8840\u8165,\u6B66\u5668,\u7578\u5F62\u7684\u624B,\u591A\u4F59\u7684\u80A2\u4F53,\u683C\u5B50\u6570\u91CF\u4E0D\u5BF9";
+export declare const PAINT_DEFAULT: {
+    model: string;
+    size: string;
+};
+export declare const PaintSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodString>;
+    size: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type PaintConfig = z.infer<typeof PaintSchema>;
 export declare const CotutorConfigSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     title: z.ZodDefault<z.ZodString>;
@@ -102,81 +284,172 @@ export declare const CotutorConfigSchema: z.ZodObject<{
         slug: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
         grade: z.ZodOptional<z.ZodString>;
+        theme: z.ZodDefault<z.ZodString>;
+        hand: z.ZodOptional<z.ZodEnum<{
+            right: "right";
+            left: "left";
+        }>>;
     }, z.core.$strip>;
     server: z.ZodDefault<z.ZodObject<{
         port: z.ZodDefault<z.ZodNumber>;
+        https: z.ZodOptional<z.ZodObject<{
+            cert: z.ZodString;
+            key: z.ZodString;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     paths: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    vault: z.ZodDefault<z.ZodObject<{
+        keepScore: z.ZodDefault<z.ZodNumber>;
+        autoBookkeep: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
     policyDefaults: z.ZodDefault<z.ZodObject<{
         replyMaxChars: z.ZodOptional<z.ZodNumber>;
-        dailyMessages: z.ZodOptional<z.ZodNumber>;
-        dailyRegen: z.ZodOptional<z.ZodNumber>;
-        reviewGate: z.ZodOptional<z.ZodBoolean>;
-        forms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            L0: "L0";
-            L1: "L1";
-            L2: "L2";
-            L3: "L3";
-            L4: "L4";
-        }>>>;
         contextPack: z.ZodOptional<z.ZodObject<{
             recent: z.ZodOptional<z.ZodNumber>;
             planLines: z.ZodOptional<z.ZodNumber>;
+            entryChars: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        tools: z.ZodOptional<z.ZodEnum<{
+            on: "on";
+            off: "off";
+        }>>;
+        board: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            auto: "auto";
+        }>>;
+        stall: z.ZodOptional<z.ZodObject<{
+            ms: z.ZodOptional<z.ZodNumber>;
+            retries: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    teachers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    tutors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         display: z.ZodString;
         subject: z.ZodOptional<z.ZodString>;
         avatar: z.ZodOptional<z.ZodString>;
+        color: z.ZodOptional<z.ZodString>;
         voice: z.ZodOptional<z.ZodString>;
         enabled: z.ZodDefault<z.ZodBoolean>;
         hidden: z.ZodDefault<z.ZodBoolean>;
+        cards: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            text: "text";
+            word: "word";
+            read: "read";
+            choice: "choice";
+            code: "code";
+            image: "image";
+            lecture: "lecture";
+            canvas: "canvas";
+            tianzige: "tianzige";
+            paint: "paint";
+            photo: "photo";
+        }>>>;
         policy: z.ZodOptional<z.ZodObject<{
             replyMaxChars: z.ZodOptional<z.ZodNumber>;
-            dailyMessages: z.ZodOptional<z.ZodNumber>;
-            dailyRegen: z.ZodOptional<z.ZodNumber>;
-            reviewGate: z.ZodOptional<z.ZodBoolean>;
-            forms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                L0: "L0";
-                L1: "L1";
-                L2: "L2";
-                L3: "L3";
-                L4: "L4";
-            }>>>;
             contextPack: z.ZodOptional<z.ZodObject<{
                 recent: z.ZodOptional<z.ZodNumber>;
                 planLines: z.ZodOptional<z.ZodNumber>;
+                entryChars: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                low: "low";
+                medium: "medium";
+                high: "high";
+            }>>;
+            tools: z.ZodOptional<z.ZodEnum<{
+                on: "on";
+                off: "off";
+            }>>;
+            board: z.ZodOptional<z.ZodEnum<{
+                off: "off";
+                auto: "auto";
+            }>>;
+            stall: z.ZodOptional<z.ZodObject<{
+                ms: z.ZodOptional<z.ZodNumber>;
+                retries: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
+        runtime: z.ZodOptional<z.ZodString>;
+        extras: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            dictation: "dictation";
+            talk: "talk";
+        }>>>;
     }, z.core.$strip>>>;
-    agents: z.ZodObject<{
+    runtimes: z.ZodObject<{
         default: z.ZodString;
-    }, z.core.$catchall<z.ZodObject<{
+    }, z.core.$catchall<z.ZodUnion<readonly [z.ZodObject<{
+        cli: z.ZodOptional<z.ZodString>;
         run: z.ZodArray<z.ZodString>;
         resume: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>>>;
+        stdin: z.ZodOptional<z.ZodLiteral<"stream-json">>;
+    }, z.core.$strip>, z.ZodObject<{
+        api: z.ZodLiteral<"bailian">;
+        model: z.ZodString;
+        maxSteps: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>>;
+    figshot: z.ZodOptional<z.ZodObject<{
+        port: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    dictation: z.ZodDefault<z.ZodObject<{
+        model: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    paint: z.ZodDefault<z.ZodObject<{
+        model: z.ZodDefault<z.ZodString>;
+        size: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    talk: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        listModel: z.ZodDefault<z.ZodString>;
+        minutes: z.ZodDefault<z.ZodNumber>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    live: z.ZodDefault<z.ZodObject<{
+        model: z.ZodDefault<z.ZodString>;
+        voices: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        listen: z.ZodDefault<z.ZodEnum<{
+            hold: "hold";
+            open: "open";
+        }>>;
+        vad: z.ZodDefault<z.ZodEnum<{
+            server_vad: "server_vad";
+            semantic_vad: "semantic_vad";
+        }>>;
+        silenceMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CotutorConfig = z.infer<typeof CotutorConfigSchema>;
-/** 老师的有效政策 = POLICY_DEFAULTS ← policyDefaults ← teachers[name].policy */
-export declare function resolvePolicy(config: CotutorConfig, teacher: string): Policy;
-export interface TeacherView {
+/** 老师的有效政策 = POLICY_DEFAULTS ← policyDefaults ← tutors[name].policy */
+export declare function resolvePolicy(config: CotutorConfig, tutor: string): Policy;
+export interface TutorView {
     name: string;
     display: string;
     subject?: string;
     avatar?: string;
+    /** cotutor.json 里写的学科色(没写 = 自动;用的颜色看 src/ui/shared/tutor-color.ts 的 tutorColors) */
+    color?: string;
     voice?: string;
     enabled: boolean;
     hidden: boolean;
     policy: Policy;
+    /** 老师卡上的常驻入口(已按学科补缺省) */
+    extras: TutorExtra[];
 }
 /** 老师列表(带有效政策);kidOnly = 只要孩子端能看到的(enabled 且不 hidden) */
-export declare function listTeachers(config: CotutorConfig, opts?: {
+export declare function listTutors(config: CotutorConfig, opts?: {
     kidOnly?: boolean;
-}): TeacherView[];
-/** 预设模板填占位符;{agentBody} 只在给了正文时替换,否则原样留着(doctor 会报) */
-export declare function fillPreset(argv: readonly string[], vars: {
+}): TutorView[];
+/** 运行时模板填占位符;{tools} 填适配器给的工具名单(src/brain/cli/ 的 fillArgs 先算好,没给就填空);{agentBody} / {systemBody} / {boardFile} 只在给了值时替换,否则原样留着(doctor 会报);{effort} 没给用出厂缺省(课文件排版这类不认老师政策的调用) */
+export declare function fillRuntime(argv: readonly string[], vars: {
     agent: string;
     prompt: string;
     session?: string;
     agentBody?: string;
+    systemBody?: string;
+    boardFile?: string;
+    effort?: Policy['effort'];
+    tools?: string;
 }): string[];