cotutor 0.2.0 → 0.3.0

package/dist/cli/skills.js

@@ -1,170 +0,0 @@
-/**
- * 出厂 skill(scene-maker 用的四个领域 skill,来自 drawtell-skills 包):与老师文件同一套「拷不链」机制——
- * init 拷进 workspace 的 .claude/skills/<name>/(拷进来就是家长的),hash 记 .cotutor/shipped.json 的 skills,
- * upgrade 没改过的换新、改过的报 diff 保留;.qwen/skills/<name> 是相对链。工作流 skill(math-explainer 等)不拷,
- * scene-maker 的工作流写在它的老师文件正文里(《drawtell接入与场景卡.md》§3)。
- * 顺带一个机器文件 .cotutor/drawtell:指向本包 node_modules 里 drawtell CLI 的壳脚本,老师用相对路径就能跑它。
- */
-import { createHash } from 'node:crypto';
-import { chmod, cp, lstat, mkdir, readFile, readdir, readlink, rm, symlink, unlink, writeFile } from 'node:fs/promises';
-import { createRequire } from 'node:module';
-import { dirname, join, relative } from 'node:path';
-import { PACKAGE_VERSION } from "./skeleton.js";
-import { readManifest, writeManifest } from "./tutors.js";
-export const SHIPPED_SKILLS = ['drawtell-scene', 'drawtell-teaching', 'drawtell-cli', 'drawtell-verify'];
-/** drawtell-skills 包的 skills/ 目录;包没装 → null(doctor 点名,init 跳过) */
-export function packageSkillsDir() {
-    try {
-        return join(dirname(createRequire(import.meta.url).resolve('drawtell-skills/package.json')), 'skills');
-    }
-    catch {
-        return null;
-    }
-}
-/** drawtell CLI 的入口(本包 node_modules 里);没装 → null */
-export function drawtellBin() {
-    try {
-        return join(dirname(createRequire(import.meta.url).resolve('drawtell/package.json')), 'bin', 'drawtell.js');
-    }
-    catch {
-        return null;
-    }
-}
-export const TOOL_SHIM = '.cotutor/drawtell';
-/** 一个目录的内容 hash:相对路径 + 内容,按路径排序 */
-export async function dirHash(dir) {
-    const files = [];
-    const walk = async (d) => {
-        for (const e of (await readdir(d, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
-            const p = join(d, e.name);
-            if (e.isDirectory())
-                await walk(p);
-            else if (e.isFile())
-                files.push(p);
-        }
-    };
-    await walk(dir);
-    const h = createHash('sha256');
-    for (const f of files.sort()) {
-        h.update(relative(dir, f));
-        h.update('\0');
-        h.update(await readFile(f));
-        h.update('\0');
-    }
-    return `sha256:${h.digest('hex')}`;
-}
-export function skillDirs(root, name) {
-    return { claude: join(root, '.claude', 'skills', name), qwen: join(root, '.qwen', 'skills', name) };
-}
-async function readState(root, name, manifest, src) {
-    const { claude } = skillDirs(root, name);
-    const st = await lstat(claude).catch(() => null);
-    if (!st?.isDirectory())
-        return { name, state: src ? 'missing' : 'unavailable', dir: claude };
-    const rec = manifest.skills?.[name];
-    const mine = await dirHash(claude);
-    if (src) {
-        const shipped = await dirHash(join(src, name)).catch(() => null);
-        if (shipped && mine === shipped)
-            return { name, state: 'latest', dir: claude, basedOn: rec?.version };
-    }
-    if (rec && rec.hash === mine)
-        return { name, state: src ? 'upgradable' : 'latest', dir: claude, basedOn: rec.version };
-    return { name, state: rec ? 'custom' : 'untracked', dir: claude, basedOn: rec?.version };
-}
-export async function skillStatuses(root) {
-    const manifest = await readManifest(root);
-    const src = packageSkillsDir();
-    const out = [];
-    for (const name of SHIPPED_SKILLS)
-        out.push(await readState(root, name, manifest, src));
-    return out;
-}
-async function installOne(root, name, src, manifest) {
-    const { claude } = skillDirs(root, name);
-    await rm(claude, { recursive: true, force: true });
-    await mkdir(dirname(claude), { recursive: true });
-    await cp(join(src, name), claude, { recursive: true });
-    manifest.skills ??= {};
-    manifest.skills[name] = { hash: await dirHash(claude), version: PACKAGE_VERSION };
-}
-async function ensureQwenLink(root, name) {
-    const { claude, qwen } = skillDirs(root, name);
-    await mkdir(dirname(qwen), { recursive: true });
-    const want = relative(dirname(qwen), claude);
-    const st = await lstat(qwen).catch(() => null);
-    if (st?.isSymbolicLink() && (await readlink(qwen).catch(() => '')) === want)
-        return 'exists';
-    if (st) {
-        if (!st.isSymbolicLink())
-            return 'exists';
-        await unlink(qwen);
-        await symlink(want, qwen);
-        return 'replaced';
-    }
-    await symlink(want, qwen);
-    return 'created';
-}
-/** init 用:缺的拷,有的不动;drawtell-skills 没装就只报一行 */
-export async function installSkills(root) {
-    const steps = [];
-    const src = packageSkillsDir();
-    if (!src)
-        return [{ item: '.claude/skills/', action: 'kept', note: 'drawtell-skills 没装,四个领域 skill 没拷(scene-maker 作业要它们);仓库根 pnpm install' }];
-    const manifest = await readManifest(root);
-    let touched = false;
-    for (const name of SHIPPED_SKILLS) {
-        const s = await readState(root, name, manifest, src);
-        const item = `.claude/skills/${name}/`;
-        if (s.state === 'missing') {
-            await installOne(root, name, src, manifest);
-            touched = true;
-            steps.push({ item, action: 'created', note: `拷自 drawtell-skills` });
-        }
-        else
-            steps.push({ item, action: 'exists', note: s.state === 'custom' ? `自定义(基于 ${s.basedOn})` : s.state === 'upgradable' ? '可升级(cotutor upgrade)' : s.state === 'untracked' ? '已有(没有出厂记录);升级时当自定义对待' : undefined });
-        const q = await ensureQwenLink(root, name);
-        steps.push({ item: `.qwen/skills/${name}`, action: q, note: q === 'exists' ? undefined : '→ ../../.claude/skills/' });
-    }
-    if (touched)
-        await writeManifest(root, { ...manifest, version: PACKAGE_VERSION });
-    return steps;
-}
-/** upgrade 用:latest 跳过;upgradable 换新;custom / untracked 保留只报;缺的补 */
-export async function upgradeSkills(root) {
-    const src = packageSkillsDir();
-    const steps = [];
-    if (!src)
-        return SHIPPED_SKILLS.map((name) => ({ name, action: 'unavailable' }));
-    const manifest = await readManifest(root);
-    for (const name of SHIPPED_SKILLS) {
-        const s = await readState(root, name, manifest, src);
-        if (s.state === 'latest')
-            steps.push({ name, action: 'latest', basedOn: s.basedOn });
-        else if (s.state === 'missing') {
-            await installOne(root, name, src, manifest);
-            steps.push({ name, action: 'installed' });
-        }
-        else if (s.state === 'upgradable') {
-            await installOne(root, name, src, manifest);
-            steps.push({ name, action: 'upgraded', basedOn: s.basedOn });
-        }
-        else
-            steps.push({ name, action: 'kept-custom', basedOn: s.basedOn });
-        await ensureQwenLink(root, name);
-    }
-    await writeManifest(root, { ...manifest, version: PACKAGE_VERSION });
-    return steps;
-}
-/** .cotutor/drawtell:壳脚本,老师在 agents/<name>/ 里用 ../../.cotutor/drawtell 跑 drawtell CLI;机器文件,init / upgrade 每次刷新 */
-export async function writeToolShim(root) {
-    const file = join(root, TOOL_SHIM);
-    const bin = drawtellBin();
-    await mkdir(dirname(file), { recursive: true });
-    const body = bin
-        ? `#!/bin/sh\n# cotutor 生成的机器文件:drawtell CLI 的壳,指向本包 node_modules 里的 drawtell;init / upgrade 会刷新\nexec node "${bin}" "$@"\n`
-        : `#!/bin/sh\necho "cotutor: node_modules 里没有 drawtell(仓库根 pnpm install),场景作业跑不了" >&2\nexit 1\n`;
-    await writeFile(file, body);
-    await chmod(file, 0o755);
-    return { file, available: bin !== null };
-}

package/dist/cli/workspace.d.ts

@@ -1,69 +0,0 @@
-import { type CotutorConfig, type PathRole } from '../schema/index.ts';
-/** 用法错误:main 捕获后 exit 2,错误信息即修复指南。 */
-export declare class UsageError extends Error {
-}
-/** 配置文件损坏或形状不对:文件在,但用不了。 */
-export declare class ConfigError extends UsageError {
-    readonly file: string;
-    constructor(file: string, cause: string);
-}
-export declare const CONFIG_FILE = "cotutor.json";
-export declare const USER_CONFIG: string;
-/** 机器级自签证书目录(cotutor cert 写 cert.pem + key.pem):证书签的是本机名与局域网 IP,与孩子无关,所以不在 workspace 里(2026-09-09 拍板) */
-export declare const USER_CERT_DIR: string;
-export declare const HOME_ROOT: string;
-export type RootSource = 'flag' | 'env' | 'cwd' | 'user-config' | 'home-single';
-export interface ResolvedRoot {
-    root: string;
-    source: RootSource;
-}
-export declare function expandPath(p: string, base: string): string;
-export declare function redactHome(value: string): string;
-export declare function redactDeep<T>(value: T): T;
-/** 读 JSON:不存在 → null;坏 → ConfigError */
-export declare function readJson(file: string): unknown | null;
-/** 从 dir 向上找 cotutor.json,找到返回目录 */
-export declare function findUp(dir: string): string | null;
-/** ~/cotutor/ 下带 cotutor.json 的子目录 */
-export declare function homeWorkspaces(homeRoot?: string): string[];
-export interface ResolveOptions {
-    env?: NodeJS.ProcessEnv;
-    cwd?: string;
-    homeRoot?: string;
-}
-export declare function resolveRoot(override?: string, opts?: ResolveOptions): ResolvedRoot;
-export interface Workspace {
-    root: string;
-    source: RootSource;
-    config: CotutorConfig;
-    /** 角色 → 绝对路径;vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根 */
-    paths: Record<PathRole, string> & Record<string, string>;
-    dirs: {
-        agents: string;
-        ledger: string;
-        conversations: string;
-        claudeAgents: string;
-        qwenAgents: string;
-        /** 场景源(scene-maker 写的 scenes/<id>.ts 与说明文件) */
-        scenes: string;
-        /** 课包(drawtell build 的产物,场景卡从这里播;派生物,gitignore) */
-        bundles: string;
-        /** 关键帧截图(drawtell snap;派生物) */
-        snaps: string;
-    };
-    files: {
-        config: string;
-        observations: string;
-        artifacts: string;
-        rulesClaude: string;
-        rulesQwen: string;
-    };
-}
-/** 校验 cotutor.json 的形状;失败 → ConfigError,信息是逐条修复指南 */
-export declare function parseConfig(raw: unknown, file: string): CotutorConfig;
-export declare function resolvePaths(root: string, paths: Record<string, string>): Workspace['paths'];
-export declare function assembleWorkspace(root: string, source: RootSource, config: CotutorConfig): Workspace;
-/** 定根 + 读配置 + 校验 + 展开角色。cotutor.json 缺失也是错(它是必需的)。 */
-export declare function loadWorkspace(override?: string, opts?: ResolveOptions): Workspace;
-/** --json / 启动日志里回报workspace(脱敏) */
-export declare function workspaceReport(ws: Workspace): Record<string, unknown>;

package/dist/lib/agent-file.d.ts

@@ -1,10 +0,0 @@
-/**
- * 老师文件文件(.claude/agents/<name>.md 同一份链到 .qwen/agents/):YAML frontmatter + 正文即系统提示。
- * 这里只认平铺的 `key: value` frontmatter(两个 CLI 的公共子集:name / description / maxTurns / permissionMode / memory);
- * 正文给没有 --agent 的 CLI 经 {agentBody} 塞进 --append-system-prompt。
- */
-export interface AgentFile {
-    frontmatter: Record<string, string>;
-    body: string;
-}
-export declare function parseAgentFile(text: string): AgentFile;

package/dist/lib/agent-file.js

@@ -1,16 +0,0 @@
-export function parseAgentFile(text) {
-    const open = /^---[^\S\n]*\n/.exec(text);
-    if (!open)
-        return { frontmatter: {}, body: text.trim() };
-    const rest = text.slice(open[0].length);
-    const end = /\n---[^\S\n]*(\n|$)/.exec(rest);
-    if (!end)
-        return { frontmatter: {}, body: text.trim() };
-    const frontmatter = {};
-    for (const raw of rest.slice(0, end.index).split('\n')) {
-        const m = /^([A-Za-z][\w-]*):\s*(.*)$/.exec(raw);
-        if (m)
-            frontmatter[m[1]] = m[2].trim().replace(/^(["'])(.*)\1$/, '$2');
-    }
-    return { frontmatter, body: rest.slice(end.index + end[0].length).trim() };
-}

package/dist/lib/board.d.ts

@@ -1,15 +0,0 @@
-import { type BoardSection } from './kid-board.ts';
-export interface ParseBoardOptions {
-    /** 文本还在长(流式):压住没闭合的围栏与没换行结束的最后一行 */
-    partial?: boolean;
-}
-export interface ParsedBoard {
-    section: BoardSection;
-    /** 没解析成的卡等,家长视图转录里显示;孩子端不报 */
-    warnings: string[];
-    /** 第一个 H2 起的尾巴(「## 家长」等,原文含标题行);没有 = 空串 */
-    tail: string;
-}
-/** 讲稿一行的清洗:去掉老师不该写但常写的标题号、列表号、引用号、粗体号;整行的 HTML 注释不算话 */
-export declare function cleanSpeech(line: string): string;
-export declare function parseBoard(text: string, opts?: ParseBoardOptions): ParsedBoard;

package/dist/lib/board.js

@@ -1,107 +0,0 @@
-/**
- * 板书解析器:老师的回复正文(已剥掉「待裁量」「转交」段)→ 一节 BoardSection。
- * 三条规则(《板书卡片设计.md》§2):围栏 = 卡(标签第一个词是 kind),普通行 = 讲稿一句,第一个 H2 起是给家长的尾巴。
- * 讲稿句里 [词] 是标注(落到第一张含这个词的卡,整节找,卡在前在后都行),[[名 参数]] 是对上一张卡的动作(cue)。
- * partial 模式给流式用:没闭合的围栏和没换行结束的最后一行压着不算,下次整段重解析自然补上。
- * 永不抛错:围栏没闭合当到文末,卡解析不出退成文字卡并记一句 warning。
- */
-import { parseCard } from "../cards/index.js";
-import { anchorMarks, isQuestion, phrasesIn, plainLine } from "./kid-board.js";
-const FENCE_OPEN = /^ {0,3}(`{3,}|~{3,})(.*)$/;
-const H2 = /^##\s+\S/;
-const CUE = /\[\[([^\[\]]+)\]\]/g;
-function fenceClose(line, fence) {
-    const m = /^ {0,3}(`{3,}|~{3,})\s*$/.exec(line);
-    return Boolean(m && m[1][0] === fence[0] && m[1].length >= fence.length);
-}
-/** 讲稿一行的清洗:去掉老师不该写但常写的标题号、列表号、引用号、粗体号;整行的 HTML 注释不算话 */
-export function cleanSpeech(line) {
-    const t = line.trim();
-    if (/^<!--.*-->$/.test(t))
-        return '';
-    return t
-        .replace(/^#{1,6}\s+/, '')
-        .replace(/^(?:[-*+]|\d+[.)])\s+/, '')
-        .replace(/^>\s*/, '')
-        .replace(/\*\*/g, '')
-        .trim();
-}
-function rawLine(line, cards) {
-    const anchor = cards.length ? cards.length - 1 : null;
-    const cues = [];
-    const text = line
-        .replace(CUE, (_, inner) => {
-        const [name, ...rest] = inner.trim().split(/\s+/);
-        if (name && anchor !== null)
-            cues.push({ card: anchor, name: name.toLowerCase(), ...(rest.length ? { arg: rest.join(' ') } : {}) });
-        return '';
-    })
-        .replace(/\s{2,}/g, ' ')
-        .trim();
-    return { text, anchor, cues };
-}
-export function parseBoard(text, opts = {}) {
-    const partial = opts.partial === true;
-    const all = text.split('\n');
-    const lines = partial && !text.endsWith('\n') ? all.slice(0, -1) : all;
-    const cards = [];
-    const raws = [];
-    const warnings = [];
-    let tail = null;
-    let i = 0;
-    while (i < lines.length) {
-        const line = lines[i];
-        if (tail) {
-            tail.push(line);
-            i++;
-            continue;
-        }
-        const open = FENCE_OPEN.exec(line);
-        if (open) {
-            const fence = open[1];
-            const tag = open[2].trim();
-            const body = [];
-            let j = i + 1;
-            let closed = false;
-            for (; j < lines.length; j++) {
-                if (fenceClose(lines[j], fence)) {
-                    closed = true;
-                    break;
-                }
-                body.push(lines[j]);
-            }
-            if (!closed && partial)
-                break;
-            if (!closed)
-                warnings.push(`围栏没闭合(${tag || '无标签'}),当到文末`);
-            const r = parseCard(tag, body.join('\n'));
-            cards.push(r.card);
-            if (r.warning)
-                warnings.push(r.warning);
-            i = closed ? j + 1 : j;
-            continue;
-        }
-        if (H2.test(line)) {
-            tail = [line];
-            i++;
-            continue;
-        }
-        const speech = cleanSpeech(line);
-        if (speech)
-            raws.push(rawLine(speech, cards));
-        i++;
-    }
-    // 标注整节找(老师把卡写在句子后面也认),所以卡收齐了再落
-    const out = raws
-        .filter((r) => r.text)
-        .map((r) => {
-        const marks = anchorMarks(cards, phrasesIn(r.text));
-        const plain = plainLine(r.text);
-        return { text: plain, audio: null, marks, ask: isQuestion(plain), anchor: r.anchor, cues: r.cues };
-    });
-    return {
-        section: { cards, lines: out, ...(partial ? { partial: true } : {}) },
-        warnings,
-        tail: tail ? tail.join('\n').trim() : '',
-    };
-}

package/dist/lib/context-pack.js

@@ -1,55 +0,0 @@
-/**
- * 上下文包序列化(《cotutor契约草案.md》§2):固定 YAML 块 + `---` + 消息原文。
- * 手写 YAML 子集:标量能裸写就裸写,其余 JSON 双引号(合法 YAML);空的 plan / recent 不写。
- */
-import { ContextPackSchema } from "../schema/index.js";
-const BARE = /^[A-Za-z0-9_][A-Za-z0-9_\-.:T]*$/;
-export function yamlScalar(v) {
-    if (typeof v !== 'string')
-        return String(v);
-    return BARE.test(v) && !/^(true|false|null|~|yes|no)$/i.test(v) ? v : JSON.stringify(v);
-}
-export function renderContextPack(pack) {
-    const p = ContextPackSchema.parse(pack);
-    const out = ['cotutor:', `  from: ${p.from}`, `  at: ${yamlScalar(p.at)}`];
-    if (p.slot)
-        out.push(`  slot: ${yamlScalar(p.slot)}`);
-    if (p.focus && (p.focus.artifact || p.focus.step !== undefined || p.focus.circled?.length || p.focus.card)) {
-        out.push('  focus:');
-        if (p.focus.artifact)
-            out.push(`    artifact: ${yamlScalar(p.focus.artifact)}`);
-        if (p.focus.step !== undefined)
-            out.push(`    step: ${p.focus.step}`);
-        if (p.focus.circled?.length)
-            out.push(`    circled: [${p.focus.circled.map(yamlScalar).join(', ')}]`);
-        if (p.focus.card)
-            out.push(`    card: ${yamlScalar(p.focus.card)}`);
-    }
-    if (p.plan.length) {
-        out.push('  plan:');
-        for (const l of p.plan)
-            out.push(`    - ${yamlScalar(l)}`);
-    }
-    if (p.recent.length) {
-        out.push('  recent:');
-        for (const r of p.recent)
-            out.push(`    - ${yamlScalar(`${r.date} ${r.claim}`)}`);
-    }
-    if (p.board === 'off')
-        out.push('  board: off');
-    if (p.cards?.length) {
-        out.push('  cards:');
-        for (const c of p.cards)
-            out.push(`    - ${yamlScalar(c)}`);
-    }
-    return out.join('\n');
-}
-/** 按政策截 plan / recent,再拼成「YAML 块 --- 消息」 */
-export function buildContextPack(pack, message, limits) {
-    const trimmed = {
-        ...pack,
-        plan: (pack.plan ?? []).slice(0, limits.planLines),
-        recent: (pack.recent ?? []).slice(-limits.recent),
-    };
-    return `${renderContextPack(trimmed)}\n---\n${message.trim()}\n`;
-}

package/dist/lib/conversation.js

@@ -1,88 +0,0 @@
-/**
- * 对话索引的纯函数:日期与 job 命名、空索引、把一次运行的结果并进索引(不改旧对象)。
- */
-import { ConversationIndexSchema } from "../schema/index.js";
-const pad = (n) => String(n).padStart(2, '0');
-/** 本地日期 YYYY-MM-DD(对话按本地日切) */
-export function localDate(d) {
-    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
-}
-/** 本地时间到分钟 YYYY-MM-DDTHH:MM(上下文包的 at) */
-export function localMinute(d) {
-    return `${localDate(d)}T${pad(d.getHours())}:${pad(d.getMinutes())}`;
-}
-/** HHMM-<序号>,同一天内不重复 */
-export function jobId(d, seq) {
-    return `${pad(d.getHours())}${pad(d.getMinutes())}-${seq}`;
-}
-export function emptyIndex(tutor, date) {
-    return ConversationIndexSchema.parse({ tutor, date });
-}
-/** conversations/<tutor>/<date>.json 与 <date>.<job>.log / .err.log / .mp3(整段配音)/ .<n>.mp3(讲稿第 n 句)/ .cards/<n>.json(卡的状态) */
-export function conversationFiles(conversationsDir, tutor, date) {
-    const base = `${conversationsDir}/${tutor}/${date}`;
-    return {
-        index: `${base}.json`,
-        log: (job) => `${base}.${job}.log`,
-        err: (job) => `${base}.${job}.err.log`,
-        audio: (job) => `${base}.${job}.mp3`,
-        lineAudio: (job, n) => `${base}.${job}.${n}.mp3`,
-        cardsDir: (job) => `${base}.${job}.cards`,
-        card: (job, n) => `${base}.${job}.cards/${n}.json`,
-        cardAssetsDir: (job, n) => `${base}.${job}.cards/${n}`,
-        cardAsset: (job, n, file) => `${base}.${job}.cards/${n}/${file}`,
-    };
-}
-/** 资产在孩子端的名字:相对 conversations/<老师>/,/api/audio 认它 */
-export function cardAssetName(date, job, n, file) {
-    return `${date}.${job}.cards/${n}/${file}`;
-}
-/** 卡的 id:<job>/<n>(n 是节里的下标,0 起);页面、上下文包、状态文件名都用它 */
-export function cardId(job, n) {
-    return `${job}/${n}`;
-}
-/** 上一轮之后改过状态的卡(按 job、下标排):发消息时逐张 describe 进上下文包 */
-export function changedCards(index, states) {
-    const last = index.messages[index.messages.length - 1]?.job;
-    if (!last)
-        return [];
-    const out = [];
-    for (const m of index.messages) {
-        const per = states[m.job];
-        if (!per)
-            continue;
-        for (const n of Object.keys(per).map(Number).sort((a, b) => a - b))
-            if (per[n].turn === last)
-                out.push({ job: m.job, n, file: per[n] });
-    }
-    return out;
-}
-export function addMessage(index, msg) {
-    return { ...index, messages: [...index.messages, msg] };
-}
-/** 一次运行收尾:写 result / cost / kidText / artifacts,首次拿到 session 就记下 */
-export function applyRun(index, job, run) {
-    const { transcript, kidView } = run;
-    const messages = index.messages.map((m) => m.job === job
-        ? {
-            ...m,
-            result: transcript.final ? (transcript.final.ok ? 'ok' : 'error') : 'running',
-            costUsd: transcript.final?.costUsd,
-            kidText: kidView.kidText,
-            artifacts: run.artifacts ?? m.artifacts,
-            runtime: run.runtime,
-            holdup: kidView.holdup,
-            handoff: kidView.handoff,
-            section: kidView.section,
-            ...(kidView.parentText ? { parentText: kidView.parentText } : {}),
-            ...(kidView.warnings.length ? { warnings: kidView.warnings } : {}),
-            error: transcript.final?.ok === false ? transcript.final.reason : null,
-            audio: run.audio ?? null,
-        }
-        : m);
-    // 会话:首次拿到就记;换了运行时(agent 不同)就以这次的为准——跨 CLI 不能 resume,索引要跟着换
-    const keep = index.session && index.session.runtime === run.runtime ? index.session : null;
-    const session = keep ?? (transcript.sessionId ? { id: transcript.sessionId, runtime: run.runtime } : index.session);
-    const costUsd = messages.reduce((s, m) => s + (m.costUsd ?? 0), 0);
-    return { ...index, session, messages, costUsd: Math.round(costUsd * 1e4) / 1e4 };
-}