cotutor 0.2.0 → 0.4.0

package/dist/lib/run-plan.js

@@ -1,32 +0,0 @@
-/**
- * 一次运行的命令规划(纯函数):按运行时选 run 还是 resume、填占位符、定 cwd 相对路径。
- * 规则:当天索引里已有会话**且**是同一运行时跑出来的 → resume;否则新开(跨天索引本来就是新的,零点后第一条自然不带 --resume;
- * 换了运行时也新开——claude 的会话 id qwen 不认)。{agentBody} 只给模板里真用到它的运行时读老师正文。
- */
-import { fillRuntime } from "../schema/index.js";
-export class RuntimeError extends Error {
-}
-export function getRuntime(config, name) {
-    const n = name ?? config.runtimes.default;
-    const p = config.runtimes[n];
-    if (n === 'default' || !p || typeof p === 'string') {
-        const known = Object.keys(config.runtimes).filter((k) => k !== 'default');
-        throw new RuntimeError(`运行时 "${n}" 不存在;cotutor.json 的 runtimes 里有:${known.join('、')}`);
-    }
-    return { name: n, runtime: p };
-}
-/** 模板里有没有用到某个占位符(决定要不要去读老师正文) */
-export function runtimeUses(runtime, placeholder) {
-    return [...runtime.run, ...runtime.resume].some((a) => a.includes(placeholder));
-}
-export function planRun(config, index, vars) {
-    const { name, runtime } = getRuntime(config, vars.runtime);
-    const session = index.session && index.session.runtime === name ? index.session.id : null;
-    const template = session ? runtime.resume : runtime.run;
-    return {
-        runtime: name,
-        argv: fillRuntime(template, { agent: vars.agent, prompt: vars.prompt, session: session ?? undefined, agentBody: vars.agentBody }),
-        resume: session !== null,
-        session,
-    };
-}

package/dist/lib/sections.d.ts

@@ -1,12 +0,0 @@
-/**
- * 最终文本里的「## 待裁量」「## 转交」段:剥出来给家长 / 应用,剩下的是给孩子的话。
- * 宽容解析:段在但解析不出(缺 question、to 不合法…)就整段留在正文里——格式是增强不是门槛。
- */
-import { type Handoff, type HoldupAsk } from '../schema/index.ts';
-export interface ParsedSections {
-    /** 去掉两种固定段后的正文 */
-    body: string;
-    holdup: HoldupAsk | null;
-    handoff: Handoff | null;
-}
-export declare function parseSections(text: string): ParsedSections;

package/dist/lib/sections.js

@@ -1,151 +0,0 @@
-/**
- * 最终文本里的「## 待裁量」「## 转交」段:剥出来给家长 / 应用,剩下的是给孩子的话。
- * 宽容解析:段在但解析不出(缺 question、to 不合法…)就整段留在正文里——格式是增强不是门槛。
- */
-import { HANDOFF_HEADING, HOLDUP_HEADING, HandoffSchema, HoldupAskSchema, } from "../schema/index.js";
-const unquote = (s) => {
-    const t = s.trim();
-    return (t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'")) ? t.slice(1, -1).trim() : t;
-};
-const H2 = /^##\s+(.+?)\s*$/;
-const SPECIAL = new Set([HOLDUP_HEADING, HANDOFF_HEADING]);
-/** 固定段里合法的行:key: value / 列表项 / 缩进的子键 */
-const FIELD_LINE = /^(?:[a-z]+:\s*.*|\s*-\s+.*|\s+[a-z]+:\s*.*)$/;
-/**
- * 切段。普通 H2 段到下一个 H2 为止;「待裁量」「转交」这两种固定段只吃字段行——
- * 遇到空行且下一非空行不是字段行,段就结束,后面的话回到正文(老师把给孩子的话放最后一段时不能被吞掉)。
- */
-function segments(text) {
-    const lines = text.split('\n');
-    const out = [{ title: null, lines: [] }];
-    let fence = false;
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (/^\s*```/.test(line))
-            fence = !fence;
-        const m = !fence && H2.exec(line);
-        if (m) {
-            out.push({ title: m[1], lines: [] });
-            continue;
-        }
-        const cur = out[out.length - 1];
-        if (cur.title !== null && SPECIAL.has(cur.title) && !line.trim()) {
-            let j = i + 1;
-            while (j < lines.length && !lines[j].trim())
-                j++;
-            const next = lines[j];
-            if (next !== undefined && !H2.test(next) && !FIELD_LINE.test(next)) {
-                out.push({ title: null, lines: [] });
-                continue;
-            }
-        }
-        cur.lines.push(line);
-    }
-    return out;
-}
-function parseHoldupBody(lines) {
-    let question = '';
-    const options = [];
-    let inOptions = false;
-    for (const raw of lines) {
-        if (!raw.trim())
-            continue;
-        let m = /^question:\s*(.*)$/.exec(raw);
-        if (m) {
-            question = unquote(m[1]);
-            inOptions = false;
-            continue;
-        }
-        if (/^options:\s*$/.test(raw)) {
-            inOptions = true;
-            continue;
-        }
-        if (!inOptions)
-            continue;
-        if (/^\S/.test(raw) && !raw.trimStart().startsWith('-')) {
-            inOptions = false;
-            continue;
-        }
-        m = /^\s*-\s+label:\s*(.*)$/.exec(raw);
-        if (m) {
-            options.push({ label: unquote(m[1]) });
-            continue;
-        }
-        m = /^\s*-\s+(.*)$/.exec(raw);
-        if (m) {
-            options.push({ label: unquote(m[1]) });
-            continue;
-        }
-        const cur = options[options.length - 1];
-        if (!cur)
-            continue;
-        m = /^\s+(label|note|recommended):\s*(.*)$/.exec(raw);
-        if (!m)
-            continue;
-        if (m[1] === 'label')
-            cur.label = unquote(m[2]);
-        else if (m[1] === 'note')
-            cur.note = unquote(m[2]);
-        else
-            cur.recommended = /^true$/i.test(m[2].trim());
-    }
-    const r = HoldupAskSchema.safeParse({ question, options: options.filter((o) => o.label) });
-    return r.success ? r.data : null;
-}
-function parseHandoffBody(lines) {
-    const kv = {};
-    const refs = [];
-    let inRefs = false;
-    for (const raw of lines) {
-        if (!raw.trim())
-            continue;
-        const m = /^([a-z]+):\s*(.*)$/.exec(raw);
-        if (m) {
-            inRefs = false;
-            if (m[1] === 'refs') {
-                const v = m[2].trim();
-                if (v.startsWith('[') && v.endsWith(']')) {
-                    refs.push(...v.slice(1, -1).split(',').map(unquote).filter(Boolean));
-                }
-                else if (v)
-                    refs.push(unquote(v));
-                else
-                    inRefs = true;
-            }
-            else
-                kv[m[1]] = unquote(m[2]);
-            continue;
-        }
-        const li = /^\s*-\s+(.*)$/.exec(raw);
-        if (li && inRefs)
-            refs.push(unquote(li[1]));
-    }
-    const r = HandoffSchema.safeParse({ to: kv.to, why: kv.why, refs });
-    return r.success ? r.data : null;
-}
-export function parseSections(text) {
-    const segs = segments(text);
-    let holdup = null;
-    let handoff = null;
-    const keep = [];
-    for (const seg of segs) {
-        if (seg.title === HOLDUP_HEADING && !holdup) {
-            const h = parseHoldupBody(seg.lines);
-            if (h) {
-                holdup = h;
-                continue;
-            }
-        }
-        if (seg.title === HANDOFF_HEADING && !handoff) {
-            const h = parseHandoffBody(seg.lines);
-            if (h) {
-                handoff = h;
-                continue;
-            }
-        }
-        if (seg.title !== null)
-            keep.push(`## ${seg.title}`);
-        keep.push(...seg.lines);
-    }
-    return { body: keep.join('\n').trim(), holdup, handoff };
-}

package/dist/lib/stream.d.ts

@@ -1,15 +0,0 @@
-/**
- * 流式:老师还在说的时候,从 stream-json 的增量事件里拼出「当前这条顶层回复的正文」,给板书的 partial 解析用。
- * claude 2.1.220 加 `--include-partial-messages` 后每个字来一条 `stream_event`(content_block_delta / text_delta),
- * 每条新消息前有 message_start;qwen 0.21.13 没有增量开关,只有整条 `assistant` 事件——两种都认:
- * delta 往当前文本上追加,message_start 时当前段带围栏或 H2 就留下(与 kid-view 的 kidSource 同一条规则:老师板书完再用工具,卡不丢)、否则丢掉,
- * 新段从空开始;顶层 assistant 的 text 块直接当作当前段(与拼出来的一样)。text() = 留下的段 + 当前段。
- * parent_tool_use_id 非空的(子代理)一律跳过;喂进来的是原始字节块,行没收完的先攒着。
- */
-export interface PartialReader {
-    /** 喂一块 stdout;返回文本有没有变 */
-    feed(chunk: string): boolean;
-    /** 当前这条顶层回复的正文(还在长) */
-    text(): string;
-}
-export declare function createPartialReader(): PartialReader;

package/dist/lib/stream.js

@@ -1,69 +0,0 @@
-/**
- * 流式:老师还在说的时候,从 stream-json 的增量事件里拼出「当前这条顶层回复的正文」,给板书的 partial 解析用。
- * claude 2.1.220 加 `--include-partial-messages` 后每个字来一条 `stream_event`(content_block_delta / text_delta),
- * 每条新消息前有 message_start;qwen 0.21.13 没有增量开关,只有整条 `assistant` 事件——两种都认:
- * delta 往当前文本上追加,message_start 时当前段带围栏或 H2 就留下(与 kid-view 的 kidSource 同一条规则:老师板书完再用工具,卡不丢)、否则丢掉,
- * 新段从空开始;顶层 assistant 的 text 块直接当作当前段(与拼出来的一样)。text() = 留下的段 + 当前段。
- * parent_tool_use_id 非空的(子代理)一律跳过;喂进来的是原始字节块,行没收完的先攒着。
- */
-const KEEP = /^\s*(?:```|~~~|## )/m;
-export function createPartialReader() {
-    let rest = '';
-    let text = '';
-    const kept = [];
-    const apply = (line) => {
-        if (!line.trim())
-            return false;
-        let e;
-        try {
-            e = JSON.parse(line);
-        }
-        catch {
-            return false;
-        }
-        if (typeof e.parent_tool_use_id === 'string' && e.parent_tool_use_id)
-            return false;
-        if (e.type === 'stream_event') {
-            const ev = e.event;
-            if (ev?.type === 'message_start') {
-                if (!text)
-                    return false;
-                if (KEEP.test(text))
-                    kept.push(text.trim());
-                text = '';
-                return true;
-            }
-            if (ev?.type === 'content_block_delta' && ev.delta?.type === 'text_delta' && typeof ev.delta.text === 'string' && ev.delta.text) {
-                text += ev.delta.text;
-                return true;
-            }
-            return false;
-        }
-        if (e.type === 'assistant' && Array.isArray(e.message?.content)) {
-            const t = e.message.content
-                .filter((b) => b.type === 'text' && typeof b.text === 'string')
-                .map((b) => b.text)
-                .join('');
-            if (t && t !== text) {
-                text = t;
-                return true;
-            }
-        }
-        return false;
-    };
-    return {
-        feed(chunk) {
-            rest += chunk;
-            let changed = false;
-            let at;
-            while ((at = rest.indexOf('\n')) >= 0) {
-                const line = rest.slice(0, at);
-                rest = rest.slice(at + 1);
-                if (apply(line))
-                    changed = true;
-            }
-            return changed;
-        },
-        text: () => [...kept, text].filter(Boolean).join('\n\n'),
-    };
-}

package/dist/lib/transcript.d.ts

@@ -1,36 +0,0 @@
-/**
- * stream-json NDJSON 转录 → 家长视图条目 + 最终文本。抄自 growth-apps 的 gen-transcript(2026-08-26 实测形状,
- * claude 2.1.220;qwen code 同族),加两样:parent_tool_use_id 非空的事件标 sub(子代理),
- * result.result 单独取出作 final——它是两个 CLI 都有的稳定锚点,孩子视图只看它。
- */
-export interface TranscriptItem {
-    /** text 说话 / tool 用工具 / tool-error 工具报错 / done 收尾 */
-    kind: 'text' | 'tool' | 'tool-error' | 'done';
-    text: string;
-    /** 来自子代理(parent_tool_use_id 非空) */
-    sub?: boolean;
-}
-export type TranscriptRow = TranscriptItem | {
-    kind: 'fold';
-    tools: TranscriptItem[];
-};
-export interface TranscriptFinal {
-    /** result.result;没有就是 null */
-    text: string | null;
-    ok: boolean;
-    /** 不 ok 时的原因(subtype 或 terminal_reason) */
-    reason: string | null;
-    costUsd?: number;
-    numTurns?: number;
-}
-export interface Transcript {
-    sessionId: string | null;
-    items: TranscriptItem[];
-    /** 收尾;还在跑就是 null */
-    final: TranscriptFinal | null;
-}
-/**
- * 展示前折叠:连续 ≥3 条工具行收成一组;报错行永不折;末尾还在长的段留最后 2 条直播。
- */
-export declare function foldRuns(items: TranscriptItem[]): TranscriptRow[];
-export declare function parseTranscript(text: string): Transcript;

package/dist/lib/transcript.js

@@ -1,95 +0,0 @@
-/**
- * stream-json NDJSON 转录 → 家长视图条目 + 最终文本。抄自 growth-apps 的 gen-transcript(2026-08-26 实测形状,
- * claude 2.1.220;qwen code 同族),加两样:parent_tool_use_id 非空的事件标 sub(子代理),
- * result.result 单独取出作 final——它是两个 CLI 都有的稳定锚点,孩子视图只看它。
- */
-const FOLD_AT = 3;
-/**
- * 展示前折叠:连续 ≥3 条工具行收成一组;报错行永不折;末尾还在长的段留最后 2 条直播。
- */
-export function foldRuns(items) {
-    const rows = [];
-    let i = 0;
-    while (i < items.length) {
-        if (items[i].kind !== 'tool') {
-            rows.push(items[i]);
-            i++;
-            continue;
-        }
-        let j = i;
-        while (j < items.length && items[j].kind === 'tool')
-            j++;
-        const run = items.slice(i, j);
-        const keep = j === items.length ? Math.min(2, run.length) : 0;
-        const folded = run.slice(0, run.length - keep);
-        if (folded.length >= FOLD_AT) {
-            rows.push({ kind: 'fold', tools: folded });
-            rows.push(...run.slice(run.length - keep));
-        }
-        else
-            rows.push(...run);
-        i = j;
-    }
-    return rows;
-}
-const clip = (s, n) => (s.length > n ? `${s.slice(0, n)}…` : s);
-const blocks = (c) => (Array.isArray(c) ? c : []);
-const blockText = (c) => (typeof c === 'string' ? c : blocks(c).map((b) => b.text ?? '').join(''));
-function toolSummary(name, input) {
-    for (const k of ['description', 'command', 'file_path', 'skill', 'pattern', 'prompt', 'url']) {
-        const v = input?.[k];
-        if (typeof v === 'string' && v.trim())
-            return `${name} · ${clip(v.trim(), 120)}`;
-    }
-    return name;
-}
-export function parseTranscript(text) {
-    let sessionId = null;
-    const items = [];
-    let final = null;
-    for (const line of text.split('\n')) {
-        if (!line.trim())
-            continue;
-        let e;
-        try {
-            e = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (!sessionId && typeof e.session_id === 'string')
-            sessionId = e.session_id;
-        const sub = typeof e.parent_tool_use_id === 'string' && e.parent_tool_use_id.length > 0 ? true : undefined;
-        if (e.type === 'assistant') {
-            for (const b of blocks(e.message?.content)) {
-                if (b.type === 'text' && b.text?.trim())
-                    items.push({ kind: 'text', text: b.text.trim(), sub });
-                else if (b.type === 'tool_use' && b.name)
-                    items.push({ kind: 'tool', text: toolSummary(b.name, b.input), sub });
-            }
-        }
-        else if (e.type === 'user') {
-            for (const b of blocks(e.message?.content))
-                if (b.type === 'tool_result' && b.is_error)
-                    items.push({ kind: 'tool-error', text: clip(blockText(b.content).trim(), 300), sub });
-        }
-        else if (e.type === 'result') {
-            const failed = Boolean(e.is_error) || Boolean(e.subtype && e.subtype !== 'success');
-            const resultText = typeof e.result === 'string' && e.result.trim() ? e.result.trim() : null;
-            if (resultText && !items.some((i) => i.kind === 'text' && !i.sub))
-                items.push({ kind: 'text', text: resultText });
-            const cost = typeof e.total_cost_usd === 'number' ? ` · $${e.total_cost_usd.toFixed(2)}` : '';
-            const turns = typeof e.num_turns === 'number' ? ` · ${e.num_turns} 轮` : '';
-            const reason = e.subtype && e.subtype !== 'success' ? e.subtype : (e.terminal_reason ?? '未知');
-            items.push({ kind: 'done', text: failed ? `本轮出错(${reason})${turns}${cost}` : `本轮结束${turns}${cost}` });
-            final = {
-                text: resultText,
-                ok: !failed,
-                reason: failed ? reason : null,
-                costUsd: typeof e.total_cost_usd === 'number' ? e.total_cost_usd : undefined,
-                numTurns: typeof e.num_turns === 'number' ? e.num_turns : undefined,
-            };
-        }
-    }
-    return { sessionId, items, final };
-}

package/dist/server/app.d.ts

@@ -1,74 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { type TranscriptRow } from '../lib/transcript.ts';
-import { type KidMessage } from '../lib/kid-view.ts';
-import { type Artifact, type ConversationIndex, type TimetableEntry } from '../schema/index.ts';
-import { type Workspace } from '../cli/workspace.ts';
-import { Runner } from './runner.ts';
-export interface RouteResult {
-    status: number;
-    json?: unknown;
-    html?: string;
-    /** 静态文件(配音);handler 流式发 */
-    file?: string;
-    contentType?: string;
-}
-export interface AppContext {
-    ws: Workspace;
-    runner: Runner;
-    /** 当前时间(测试可注入;孩子端「今天」与 today 别名都按它) */
-    now: () => Date;
-    /** 上次重载失败的原因(配置改坏了),健康接口回报 */
-    configError: string | null;
-    /** 重读 cotutor.json(改了才读) */
-    reload(): Promise<void>;
-}
-export declare function createContext(ws: Workspace, opts?: {
-    now?: () => Date;
-    env?: NodeJS.ProcessEnv;
-}): AppContext;
-/** 一天的家长视图:索引 + 每条消息的转录行(主线 + 子代理折叠)+ 出错时的 err.log 尾巴 */
-export interface DayView {
-    index: ConversationIndex;
-    running: string | null;
-    runs: Record<string, TranscriptRow[]>;
-    errors: Record<string, string>;
-}
-export declare function dayView(ctx: AppContext, tutor: string, date: string): Promise<DayView>;
-/** 孩子端看到的老师:enabled 且不 hidden;每日上限用完 available = false(头像灰) */
-export interface KidTutor {
-    name: string;
-    display: string;
-    avatar: string | null;
-    subject: string | null;
-    hasVoice: boolean;
-    remaining: number;
-    available: boolean;
-}
-export declare function kidTutors(ctx: AppContext, date: string): Promise<KidTutor[]>;
-export interface KidHome {
-    title: string;
-    date: string;
-    /** 1–7 */
-    day: number;
-    timetable: TimetableEntry[];
-    slot: string | null;
-    tutors: KidTutor[];
-    /** 今天的产物,按学科(老师的 subject)分叠;验收开关开着的老师只给 accepted 的 */
-    stacks: {
-        subject: string;
-        tutor: string | null;
-        items: Artifact[];
-    }[];
-}
-export declare function kidHome(ctx: AppContext, now: Date): Promise<KidHome>;
-export interface KidDay {
-    tutor: string;
-    date: string;
-    messages: KidMessage[];
-    remaining: number;
-    /** 老师正在回的那条 job */
-    pending: string | null;
-}
-export declare function kidDay(ctx: AppContext, tutor: string, date: string): Promise<KidDay>;
-export declare function route(method: string, path: string, ctx: AppContext, body?: unknown): Promise<RouteResult>;
-export declare function createHandler(ctx: AppContext): (req: IncomingMessage, res: ServerResponse) => void;