cotutor 0.2.0 → 0.4.0

package/dist/schema/config.d.ts

@@ -1,131 +1,307 @@
 /**
  * cotutor.json:每个 workspace 一份,一孩一 workspace。承接 drawtell.json 的做法——
  * `paths` 角色映射 + `runtimes` 的 {run, resume} 命令模板——再加老师表与政策。
- * 字段归属铁律:老师的 .md 文件里只有 name / description / maxTurns / permissionMode / memory + 正文;
- * 人设(display / avatar / voice)、政策、开关全在这里。老师团页只改本文件,永不改链进来的定义文件。
+ * 字段归属铁律:老师的 .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];
+import { DEFAULT_PORT } from '../shared/default-port.ts';
+export { DEFAULT_PORT };
 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<{
-        auto: "auto";
         off: "off";
+        auto: "auto";
     }>;
-    scenes: z.ZodObject<{
-        dailyMax: z.ZodNumber;
+    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<{
-        auto: "auto";
         off: "off";
+        auto: "auto";
     }>>;
-    scenes: z.ZodOptional<z.ZodObject<{
-        dailyMax: z.ZodOptional<z.ZodNumber>;
+    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 TUTOR_EXTRAS: readonly ["dictation", "talk"];
+export type TutorExtra = (typeof TUTOR_EXTRAS)[number];
+/**
+ * 老师卡上常驻的三块方砖(设计稿 https://claude.ai/artifact/NpPFoyvuF17dbRSEUuRJfW):先后就是牌上的先后。
+ * id 记在消息的 via.button;activity 是老师家里同名的文件(agents/<老师>/activities/<名>.md),孩子看到的字也是它。
+ * 家里有那个文件才出那一块(三门主科出厂都有);cotutor.json 的 tiles 只记关掉的,升级来的老 workspace 自动就有
+ */
+export declare const HOME_TILES: readonly [{
+    readonly id: "preview";
+    readonly activity: "预习";
+}, {
+    readonly id: "check";
+    readonly activity: "检查作业";
+}, {
+    readonly id: "review";
+    readonly activity: "复习";
+}];
+export type HomeTileId = (typeof HOME_TILES)[number]['id'];
+export declare const HOME_TILE_IDS: [HomeTileId, ...HomeTileId[]];
 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<{
-            auto: "auto";
             off: "off";
+            auto: "auto";
         }>>;
-        scenes: z.ZodOptional<z.ZodObject<{
-            dailyMax: z.ZodOptional<z.ZodNumber>;
+        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";
+    }>>>;
+    tiles: z.ZodOptional<z.ZodObject<{
+        check: z.ZodOptional<z.ZodBoolean>;
+        preview: z.ZodOptional<z.ZodBoolean>;
+        review: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 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';
 /**
- * 运行时:一个 CLI 一组 {run, resume} 命令模板。占位符:
- * {agent} 老师名 / {agentBody} 老师文件正文(给没有 --agent 的 CLI 塞系统提示)/ {prompt} 消息 / {session} 会话 id。
- * 政策旋钮(预算、轮数、模型)写进模板,换 agent 只换运行时。
+ * 这位老师卡上的常驻入口:配了照配的;没配按学科——语文 = 听写;英语 = 口语课,要口语课开着(talkOn = talk.enabled)
  */
-export declare const RuntimeSchema: z.ZodObject<{
+export declare function tutorExtras(t: Pick<Tutor, 'extras' | 'subject'>, talkOn?: boolean): TutorExtra[];
+/** 这位老师开着的方砖(牌上的先后);家里有没有那个 activity 文件不在这里管 */
+export declare function tutorTiles(t: Pick<Tutor, 'tiles'>): HomeTileId[];
+/**
+ * 旧的命令行运行时:一组 {run, resume} 命令模板(起 Qwen Code;更早是 Claude CLI)。2026-11-02 起不再支持,
+ * 留着这个形状只为旧 cotutor.json 读得进来:doctor 报出来,用到它的老师发不出去(src/brain/runtime.ts)。
+ */
+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 CliRuntime = z.infer<typeof CliRuntimeSchema>;
+/**
+ * API 运行时(2026-10-29;2026-11-02 起只有它):应用自己直连模型(src/brain/api.ts)。
+ * 现在只有百炼(OpenAI 兼容的 Chat Completions);凭证是机器级的 ~/.config/cotutor/(家长端「首页」填的按量 key 与业务空间 id,开发机还有 Token Plan)。
+ * 系统提示 = 老师正文 + 板书写法;同一话题的模型历史由应用存;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>>>;
+    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>]>>>;
 /**
- * 配音运行时:老师说完,应用把 kidText 合成一段音频给孩子端播。占位符 {text} {voice} {out}(输出文件路径)。
- * 命令要把音频写到 {out};没配、没装、失败 → 这条没有音频,孩子端退回浏览器自带的合成声。
+ * paths 里 CLI 认识的角色;其余角色原样保留给应用层。vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根;
+ * captures(应用拍的作业照片)是 workspace 侧,相对 workspace 根(《obsidian仓库设计.md》§5:vault 里存文字不存图)。
+ * 缺省是中文名(2026-09-14):vault 是家长在 Obsidian 里看的,目录名要像人写的。
  */
-export declare const TtsSchema: z.ZodObject<{
-    say: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-export type Tts = z.infer<typeof TtsSchema>;
-export declare const TTS_DEFAULT: Tts;
-/** paths 里 CLI 认识的角色;其余角色原样保留给应用层。vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根 */
-export declare const PATH_ROLES: readonly ["vault", "photos", "diary", "plans", "profile", "timetable"];
+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;
+/** 卡的配音(点读、单词卡、听写念词)的缺省:出厂三位各一个(2026-11-03 照 Ray 那里用着的),不写进 cotutor.json;别的老师没配就不配音 */
+export declare const SHIPPED_CARD_VOICES: Readonly<Record<string, string>>;
+/** 这位老师卡的配音用哪个音色:家长挑的,没挑用出厂的;都没有 undefined(不配音) */
+export declare const cardVoice: (tutors: Readonly<Record<string, {
+    voice?: string;
+}>>, tutor: string) => string | undefined;
+/**
+ * 听写:拍照认词表用哪个模型。挑词的要求在听写 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>;
@@ -133,6 +309,11 @@ 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>;
@@ -142,71 +323,132 @@ export declare const CotutorConfigSchema: z.ZodObject<{
         }, 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<{
-            auto: "auto";
             off: "off";
+            auto: "auto";
         }>>;
-        scenes: z.ZodOptional<z.ZodObject<{
-            dailyMax: z.ZodOptional<z.ZodNumber>;
+        stall: z.ZodOptional<z.ZodObject<{
+            ms: z.ZodOptional<z.ZodNumber>;
+            retries: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     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<{
-                auto: "auto";
                 off: "off";
+                auto: "auto";
             }>>;
-            scenes: z.ZodOptional<z.ZodObject<{
-                dailyMax: z.ZodOptional<z.ZodNumber>;
+            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";
+        }>>>;
+        tiles: z.ZodOptional<z.ZodObject<{
+            check: z.ZodOptional<z.ZodBoolean>;
+            preview: z.ZodOptional<z.ZodBoolean>;
+            review: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
     }, z.core.$strip>>>;
     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>>>;
-    tts: z.ZodDefault<z.ZodObject<{
-        say: 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>]>>>;
+    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>;
@@ -217,24 +459,18 @@ export interface TutorView {
     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[];
+    /** 开着的方砖(没管家里有没有那个文件) */
+    tiles: HomeTileId[];
 }
 /** 老师列表(带有效政策);kidOnly = 只要孩子端能看到的(enabled 且不 hidden) */
 export declare function listTutors(config: CotutorConfig, opts?: {
     kidOnly?: boolean;
 }): TutorView[];
-/** 运行时模板填占位符;{agentBody} 只在给了正文时替换,否则原样留着(doctor 会报) */
-export declare function fillRuntime(argv: readonly string[], vars: {
-    agent: string;
-    prompt: string;
-    session?: string;
-    agentBody?: string;
-}): string[];
-export declare function fillTts(argv: readonly string[], vars: {
-    text: string;
-    voice: string;
-    out: string;
-}): string[];