mingdao-harness 0.2.3 → 0.2.5

package/src/tools/bash.js

@@ -15,22 +15,22 @@ const MAX_TIMEOUT_SECONDS = 600;
 // 整体关闭（回到完全透传）。
 const SENSITIVE_ENV_PAIR = /(api[_-]?key|access[_-]?key|client[_-]?secret|private[_-]?key)/i;
 const SENSITIVE_ENV_SEGMENT = /(^|_)(token|secret|password|passwd|credential|authorization|auth)(_|$)/i;
-const isSensitiveEnv = (k) => SENSITIVE_ENV_PAIR.test(k) || SENSITIVE_ENV_SEGMENT.test(k);
+const isSensitiveEnv = (/** @type {any} */ k) => SENSITIVE_ENV_PAIR.test(k) || SENSITIVE_ENV_SEGMENT.test(k);
 
-function buildChildEnv(ctx, filterSensitive) {
+function buildChildEnv(/** @type {any} */ ctx, /** @type {any} */ filterSensitive) {
   if (!filterSensitive) return process.env;
   const keep = new Set((ctx?.cfg?.bashEnvKeep || []).map(String));
   const env = {};
   for (const [k, v] of Object.entries(process.env)) {
-    if (!isSensitiveEnv(k) || keep.has(k)) env[k] = v;
+    if (!isSensitiveEnv(k) || keep.has(k)) (/** @type {any} */ (env))[k] = v;
   }
   return env;
 }
 
-let sandboxSupport = null;
+let /** @type {any} */ sandboxSupport = null;
 
 export function detectSandbox() {
-  if (sandboxSupport !== null) return sandboxSupport;
+  if (/** @type {any} */ sandboxSupport !== null) return /** @type {any} */ sandboxSupport;
   sandboxSupport = 'none';
   if (process.platform === 'linux') {
     try {
@@ -46,12 +46,12 @@ export function detectSandbox() {
 // 输出折叠（审计 MiniMax §3.3-E / v0.1.48 P1-G）：模型回填的 bash 输出先折叠再截断——
 // 1) 剥离 ANSI 转义序列（CSI/OSC）；2) 连续重复行（>3 行相同）折叠为「首行 + 重复标记」。
 // npm install 类输出通常 30-50KB → 折叠后 5-10KB，单次工具回填省 60-70% prompt token。
-function stripAnsi(s) {
+function stripAnsi(/** @type {any} */ s) {
   return s
     .replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, '')
     .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, '');
 }
-function foldRepeats(s) {
+function foldRepeats(/** @type {any} */ s) {
   const lines = s.split('\n');
   const out = [];
   let i = 0;
@@ -69,12 +69,12 @@ function foldRepeats(s) {
   }
   return out.join('\n');
 }
-function tail(s, n) {
+function tail(/** @type {any} */ s, /** @type {any} */ n) {
   const folded = foldRepeats(stripAnsi(s));
   return folded.length > n ? `…[输出过长，已截断头部]\n${folded.slice(-n)}` : folded;
 }
 
-export function runBash(args, ctx) {
+export function runBash(/** @type {any} */ args, /** @type {any} */ ctx) {
   const command = String(args.command ?? '');
   if (!command.trim()) return { ok: false, error: 'command 参数为空。' };
   const timeoutSec = Math.min(Number(args.timeout) || 120, MAX_TIMEOUT_SECONDS);
@@ -125,13 +125,13 @@ export function runBash(args, ctx) {
     let done = false;
     let timedOut = false;
     // 输出增量截断：超长输出只保留尾部，避免内存无限累积
-    const cap = (s, d) => {
+    const cap = (/** @type {any} */ s, /** @type {any} */ d) => {
       const t = s + d;
       return t.length > MAX_OUTPUT * 2 ? t.slice(-MAX_OUTPUT * 2) : t;
     };
-    const killGroup = (sig) => {
+    const killGroup = (/** @type {any} */ sig) => {
       try {
-        process.kill(-child.pid, sig);
+        process.kill(-(/** @type {any} */ (child)).pid, sig);
       } catch {
         try {
           child.kill(sig);

package/src/tools/fs-tools.js

@@ -9,11 +9,18 @@ const MAX_GLOB_RESULTS = 1000;
 const MAX_GREP_MATCHES = 250;
 const MAX_FILE_BYTES = 5 * 1024 * 1024;
 
+/**
+ * @param {any} cwd
+ * @param {any} p
+ */
 function resolvePath(cwd, p) {
   if (path.isAbsolute(p)) return path.normalize(p);
   return path.resolve(cwd, p);
 }
 
+/**
+ * @param {any} buf
+ */
 function isProbablyBinary(buf) {
   const head = buf.subarray(0, 8192);
   for (let i = 0; i < head.length; i++) {
@@ -25,6 +32,10 @@ function isProbablyBinary(buf) {
 // —— undo 备份（会话级，每文件最多 10 份 + 全局上限，质检 M9） ——
 const UNDO_MAX_FILES = 64;
 const UNDO_MAX_BYTES = 20 * 1024 * 1024;
+/**
+ * @param {any} ctx
+ * @param {any} p
+ */
 function backup(ctx, p) {
   try {
     const store = ctx?.undoStore?.backups;
@@ -57,6 +68,10 @@ function backup(ctx, p) {
   } catch {}
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function undo(args, ctx) {
   const store = ctx?.undoStore?.backups;
   if (!(store instanceof Map) || !store.size) return { ok: false, error: '没有可撤销的修改。' };
@@ -68,7 +83,7 @@ export function undo(args, ctx) {
     try {
       fs.writeFileSync(p, last.content);
       return { ok: true, output: `已撤销 ${p} 的最近一次修改（该文件剩余备份 ${list.length} 个）。` };
-    } catch (err) {
+    } catch (/** @type {any} */ err) {
       return { ok: false, error: `撤销失败：${err?.message || err}` };
     }
   }
@@ -87,7 +102,7 @@ export function undo(args, ctx) {
   try {
     fs.writeFileSync(latestFile, last.content);
     return { ok: true, output: `已撤销 ${latestFile} 的最近一次修改。` };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `撤销失败：${err?.message || err}` };
   }
 }
@@ -95,10 +110,17 @@ export function undo(args, ctx) {
 const READ_CACHE_MAX = 200; // 会话级 read 缓存条数上限（超出清最旧，防止无界增长）
 const readCache = new Map(); // 绝对路径 → { mtimeMs, size, lines }
 
+/**
+ * @param {any} p
+ */
 export function invalidateReadCache(p) {
   readCache.delete(p);
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function read(args, ctx) {
   try {
     const p = resolvePath(ctx.cwd, args.path ?? '');
@@ -145,13 +167,17 @@ export function read(args, ctx) {
         out.join('\n') + (truncated ? `\n…[共 ${lines.length} 行，已显示第 ${offset}-${end} 行]` : ''),
       totalLines: lines.length,
     };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `读取失败：${err?.message || err}` };
   }
 }
 
 const MAX_WRITE_BYTES = 2 * 1024 * 1024; // write 单次内容上限（防模型输出超大文件打爆磁盘）
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function write(args, ctx) {
   try {
     const p = resolvePath(ctx.cwd, args.path ?? '');
@@ -171,12 +197,17 @@ export function write(args, ctx) {
     fs.writeFileSync(p, content);
     invalidateReadCache(p);
     return { ok: true, output: `已写入 ${p}（${Buffer.byteLength(content)} 字节）。` };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `写入失败：${err?.message || err}` };
   }
 }
 
 // 提取替换区域（含上下文），供 TUI 渲染变更预览
+/**
+ * @param {any} text
+ * @param {any} lineStart
+ * @param {any} lineCount
+ */
 function regionAround(text, lineStart, lineCount, context = 2) {
   const lines = text.split('\n');
   const from = Math.max(0, lineStart - context);
@@ -184,6 +215,10 @@ function regionAround(text, lineStart, lineCount, context = 2) {
   return lines.slice(from, to).join('\n');
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function edit(args, ctx) {
   try {
     const p = resolvePath(ctx.cwd, args.path ?? '');
@@ -218,11 +253,15 @@ export function edit(args, ctx) {
       output: `已编辑 ${p}（替换 ${count} 处）。`,
       diff: { before, after },
     };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `编辑失败：${err?.message || err}` };
   }
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function ls(args, ctx) {
   try {
     const p = resolvePath(ctx.cwd, args.path || '.');
@@ -243,11 +282,14 @@ export function ls(args, ctx) {
         return ad - bd || a.localeCompare(b);
       });
     return { ok: true, output: rows.join('\n') || '(空目录)' };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `列目录失败：${err?.message || err}` };
   }
 }
 
+/**
+ * @param {any} pattern
+ */
 function globToRegExp(pattern) {
   let re = '';
   for (let i = 0; i < pattern.length; i++) {
@@ -275,6 +317,10 @@ function globToRegExp(pattern) {
   return new RegExp('^' + re + '$');
 }
 
+/**
+ * @param {any} root
+ * @param {(full: any) => any} visitor
+ */
 function walkFiles(root, visitor) {
   const stack = [root];
   let scanned = 0;
@@ -300,6 +346,10 @@ function walkFiles(root, visitor) {
   return scanned;
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function glob(args, ctx) {
   try {
     const pattern = String(args.pattern ?? '*');
@@ -307,6 +357,7 @@ export function glob(args, ctx) {
     if (!fs.existsSync(root)) return { ok: false, error: `目录不存在：${root}` };
     const re = globToRegExp(pattern);
     const matchRel = pattern.includes('/');
+    /** @type {any[]} */
     const results = [];
     let truncated = false;
     walkFiles(root, (full) => {
@@ -321,11 +372,15 @@ export function glob(args, ctx) {
     if (!results.length) output = '(无匹配)';
     if (truncated) output += `\n…[结果超过 ${MAX_GLOB_RESULTS} 条，已截断]`;
     return { ok: true, output };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `glob 失败：${err?.message || err}` };
   }
 }
 
+/**
+ * @param {any} args
+ * @param {any} ctx
+ */
 export function grep(args, ctx) {
   try {
     const pattern = String(args.pattern ?? '');
@@ -338,14 +393,16 @@ export function grep(args, ctx) {
     let re;
     try {
       re = new RegExp(pattern);
-    } catch (e) {
+    } catch (/** @type {any} */ e) {
       return { ok: false, error: `无效的正则表达式：${e.message}` };
     }
     // 单行截断：超长行（如压缩的 JS/日志）截到 20KB 再匹配，防止正则开销失控
     const MAX_LINE = 20 * 1024;
+    /** @type {(line: any) => any} */
     const testLine = (line) => (line.length > MAX_LINE ? re.test(line.slice(0, MAX_LINE)) : re.test(line));
     const root = resolvePath(ctx.cwd, args.path || '.');
     const include = args.include ? globToRegExp(String(args.include)) : null;
+    /** @type {any[]} */
     const matches = [];
     let truncated = false;
     let scannedFiles = 0;
@@ -386,7 +443,7 @@ export function grep(args, ctx) {
       ? `\n…[匹配超过 ${MAX_GREP_MATCHES} 条，已截断；已扫描 ${scannedFiles} 个文件]`
       : `\n[已扫描 ${scannedFiles} 个文件]`;
     return { ok: true, output };
-  } catch (err) {
+  } catch (/** @type {any} */ err) {
     return { ok: false, error: `grep 失败：${err?.message || err}` };
   }
 }

package/src/tools/index.js

@@ -11,9 +11,9 @@ export const READONLY_TOOLS = new Set(['read', 'glob', 'grep', 'ls', 'skill']);
 const READ_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要读取的文件路径（相对或绝对）。' },
+    path: { type: 'string', description: '文件路径（相对或绝对）。' },
     offset: { type: 'integer', description: '起始行号，默认 1。' },
-    limit: { type: 'integer', description: '最大返回行数，默认 400。' },
+    limit: { type: 'integer', description: '最大行数，默认 400。' },
   },
   required: ['path'],
 };
@@ -21,7 +21,7 @@ const READ_SCHEMA = {
 const WRITE_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要创建或覆盖的文件路径。' },
+    path: { type: 'string', description: '文件路径。' },
     content: { type: 'string', description: '完整文件内容（UTF-8）。' },
   },
   required: ['path', 'content'],
@@ -30,10 +30,10 @@ const WRITE_SCHEMA = {
 const EDIT_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要修改的文件路径。' },
-    old_string: { type: 'string', description: '文件中真实存在的原文片段，必须逐字符完全一致。' },
-    new_string: { type: 'string', description: '替换后的文本。' },
-    replace_all: { type: 'boolean', description: '是否替换所有匹配处，默认 false。' },
+    path: { type: 'string', description: '文件路径。' },
+    old_string: { type: 'string', description: '原文片段，必须逐字一致。' },
+    new_string: { type: 'string', description: '替换后文本。' },
+    replace_all: { type: 'boolean', description: '替换所有匹配，默认 false。' },
   },
   required: ['path', 'old_string', 'new_string'],
 };
@@ -41,15 +41,15 @@ const EDIT_SCHEMA = {
 const LS_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '目录路径，默认当前工作目录。' },
+    path: { type: 'string', description: '目录路径，默认当前目录。' },
   },
 };
 
 const GLOB_SCHEMA = {
   type: 'object',
   properties: {
-    pattern: { type: 'string', description: '通配符模式，如 src/**/*.js、*.md。' },
-    path: { type: 'string', description: '搜索根目录，默认当前工作目录。' },
+    pattern: { type: 'string', description: '通配符模式，如 src/**/*.js。' },
+    path: { type: 'string', description: '搜索根目录。' },
   },
   required: ['pattern'],
 };
@@ -58,8 +58,8 @@ const GREP_SCHEMA = {
   type: 'object',
   properties: {
     pattern: { type: 'string', description: '正则表达式。' },
-    path: { type: 'string', description: '搜索根目录，默认当前工作目录。' },
-    include: { type: 'string', description: '文件名通配符过滤，如 *.js。' },
+    path: { type: 'string', description: '搜索根目录。' },
+    include: { type: 'string', description: '文件名过滤，如 *.js。' },
   },
   required: ['pattern'],
 };
@@ -67,7 +67,7 @@ const GREP_SCHEMA = {
 const BASH_SCHEMA = {
   type: 'object',
   properties: {
-    command: { type: 'string', description: '要执行的 shell 命令。执行前会请求用户授权。' },
+    command: { type: 'string', description: 'shell 命令。执行前需用户授权。' },
     timeout: { type: 'integer', description: '超时秒数，默认 120。' },
   },
   required: ['command'],
@@ -76,16 +76,16 @@ const BASH_SCHEMA = {
 const SKILL_SCHEMA = {
   type: 'object',
   properties: {
-    name: { type: 'string', description: '技能名；省略时列出所有可用技能。' },
+    name: { type: 'string', description: '技能名；省略则列出全部。' },
   },
 };
 
 const TASK_SCHEMA = {
   type: 'object',
   properties: {
-    description: { type: 'string', description: '子任务一句话描述（用于进度展示）。' },
-    prompt: { type: 'string', description: '交给子代理的完整任务说明（它没有当前对话上下文）。' },
-    readOnly: { type: 'boolean', description: '只读调研任务（不写文件不执行命令）。多个 readOnly 子任务会并行执行。' },
+    description: { type: 'string', description: '子任务一句话描述。' },
+    prompt: { type: 'string', description: '子代理的完整任务说明。' },
+    readOnly: { type: 'boolean', description: '只读调研任务，可并行。' },
   },
   required: ['prompt'],
 };
@@ -112,7 +112,7 @@ const TODO_SCHEMA = {
 const UNDO_SCHEMA = {
   type: 'object',
   properties: {
-    path: { type: 'string', description: '要撤销的文件；省略时撤销最近一次修改的文件。' },
+    path: { type: 'string', description: '要撤销的文件；省略撤销最近一次。' },
   },
 };
 
@@ -121,7 +121,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'read',
-      description: '读取文本文件，返回带行号的内容。修改文件前务必先读取。',
+      description: '读取文件内容（带行号）。修改文件前必须先读。',
       parameters: READ_SCHEMA,
     },
   },
@@ -129,7 +129,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'write',
-      description: '创建新文件或完全覆盖已有文件（自动创建父目录）。',
+      description: '创建新文件或整体覆盖（自动建父目录）。',
       parameters: WRITE_SCHEMA,
     },
   },
@@ -137,7 +137,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'edit',
-      description: '对文件做精确文本替换。old_string 必须与文件内容完全一致；匹配多处时需 replace_all=true 或提供更精确上下文。',
+      description: '精确文本替换：old_string 必须逐字匹配原文；多处匹配需 replace_all=true。',
       parameters: EDIT_SCHEMA,
     },
   },
@@ -145,7 +145,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'ls',
-      description: '列出目录内容，目录以 / 结尾。',
+      description: '列出目录内容（目录以 / 结尾）。',
       parameters: LS_SCHEMA,
     },
   },
@@ -153,7 +153,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'glob',
-      description: '按通配符模式查找文件路径（支持 * 与 **）。',
+      description: '按通配符查找文件路径（支持 * 与 **）。',
       parameters: GLOB_SCHEMA,
     },
   },
@@ -161,7 +161,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'grep',
-      description: '在文件内容中按正则表达式搜索，返回「文件:行号: 内容」。',
+      description: '正则搜索文件内容，返回「文件:行号: 内容」。',
       parameters: GREP_SCHEMA,
     },
   },
@@ -169,7 +169,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'bash',
-      description: '执行 shell 命令并返回输出（stdout/stderr/退出码）。需要用户授权。',
+      description: '执行 shell 命令，返回输出与退出码。需用户授权。',
       parameters: BASH_SCHEMA,
     },
   },
@@ -177,7 +177,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'skill',
-      description: '加载指定技能的 SKILL.md 全文；省略 name 时列出可用技能。任务与技能匹配时应先加载。',
+      description: '加载技能 SKILL.md 全文；省略 name 则列出可用技能。',
       parameters: SKILL_SCHEMA,
     },
   },
@@ -185,7 +185,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'task',
-      description: '把独立子任务委托给一个全新上下文的子代理，返回其汇报。适合搜索调研、独立实现、复核验证等可并行的工作。',
+      description: '把独立子任务委托给新上下文子代理并返回汇报；readOnly 只读任务可并行。',
       parameters: TASK_SCHEMA,
     },
   },
@@ -193,7 +193,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'todo',
-      description: '维护任务清单（全量替换）。多步骤任务开始前建立清单，完成一项更新一项。',
+      description: '维护任务清单（全量替换）。多步任务先建清单再逐项更新。',
       parameters: TODO_SCHEMA,
     },
   },
@@ -201,7 +201,7 @@ const TOOLS = [
     type: 'function',
     function: {
       name: 'undo',
-      description: '撤销 write/edit 造成的最近一次文件修改；指定 path 则撤销该文件。',
+      description: '撤销最近一次 write/edit 修改；指定 path 撤销该文件。',
       parameters: UNDO_SCHEMA,
     },
   },
@@ -211,10 +211,51 @@ export function toolSchemas() {
   return TOOLS;
 }
 
-function runSkill(args, ctx) {
+/**
+ * 递归去除对象中的全部 description 键（保留类型/required/enum 等结构性字段）。
+ * @param {any} obj
+ * @returns {any}
+ */
+function stripDescriptions(obj) {
+  if (Array.isArray(obj)) return obj.map(stripDescriptions);
+  if (obj && typeof obj === 'object') {
+    const out = /** @type {Record<string, any>} */ ({});
+    for (const [k, v] of Object.entries(obj)) {
+      if (k === 'description') continue;
+      out[k] = stripDescriptions(v);
+    }
+    return out;
+  }
+  return obj;
+}
+
+/**
+ * 按需构建工具 Schema（省钱 B1）：本会话已调用过的工具省略全部描述（工具级 + 参数级，
+ * 模型已在消息历史里见过其用途，保留 name/parameters 结构与类型即可），未用过的保留完整描述。
+ * 返回浅拷贝新数组，不修改原 TOOLS；extra（如 MCP 工具）按同一规则处理。
+ * @param {Set<string>} usedNames 已调用工具名（内置名或 MCP 前缀名）
+ * @param {Array<object>} [extra] 附加工具 Schema（MCP 等）
+ * @returns {Array<any>}
+ */
+export function buildToolSchemas(usedNames, extra = []) {
+  const strip = (/** @type {any[]} */ arr) =>
+    arr.map((/** @type {any} */ t) => {
+      const name = t?.function?.name;
+      if (name && usedNames.has(name)) {
+        return {
+          ...t,
+          function: { ...t.function, description: '', parameters: stripDescriptions(t.function?.parameters) },
+        };
+      }
+      return t;
+    });
+  return [...strip(TOOLS), ...strip(extra)];
+}
+
+function runSkill(/** @type {any} */ args, /** @type {any} */ ctx) {
   const name = String(args.name ?? '').trim();
   const skills = listSkills(ctx.workingDir);
-  const label = (s) => `${s.name}${s.source === 'user' ? '（用户级）' : s.source === 'builtin' ? '（内置）' : ''}`;
+  const label = (/** @type {any} */ s) => `${s.name}${s.source === 'user' ? '（用户级）' : s.source === 'builtin' ? '（内置）' : ''}`;
   if (!name) {
     return {
       ok: true,
@@ -230,7 +271,7 @@ function runSkill(args, ctx) {
   return { ok: true, output: `技能 ${name}${s.source === 'builtin' ? '（内置）' : ''}（${s.path}）：\n\n${s.content}` };
 }
 
-async function runTask(args, ctx) {
+async function runTask(/** @type {any} */ args, /** @type {any} */ ctx) {
   const prompt = String(args.prompt ?? '');
   const description = String(args.description ?? '');
   if (!prompt) return { ok: false, error: '缺少 prompt 参数。' };
@@ -239,11 +280,11 @@ async function runTask(args, ctx) {
     const out = await ctx.spawnTask(prompt, { description, readOnly: args.readOnly === true });
     return { ok: true, output: out };
   } catch (err) {
-    return { ok: false, error: `子任务失败：${err?.message || err}` };
+    return { ok: false, error: `子任务失败：${(/** @type {any} */ (err))?.message || err}` };
   }
 }
 
-function runTodo(args, ctx) {
+function runTodo(/** @type {any} */ args, /** @type {any} */ ctx) {
   const list = Array.isArray(args.todos) ? args.todos : [];
   if (Array.isArray(ctx.todos)) {
     ctx.todos.splice(0, ctx.todos.length, ...list);
@@ -252,12 +293,12 @@ function runTodo(args, ctx) {
     ok: true,
     output:
       `任务清单已更新（${list.length} 项）：\n` +
-      list.map((t) => `- [${t.status || 'pending'}] ${t.content}`).join('\n'),
+      list.map((/** @type {any} */ t) => `- [${t.status || 'pending'}] ${t.content}`).join('\n'),
     todos: list,
   };
 }
 
-export async function dispatch(name, args, ctx) {
+export async function dispatch(/** @type {any} */ name, /** @type {any} */ args, /** @type {any} */ ctx) {
   switch (name) {
     case 'read':
       return read(args, ctx);