pi-coding-master 0.2.7

package/core/individual.bio.organs/heart.main/process.ts

@@ -0,0 +1,122 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { Type } from "@sinclair/typebox";
+import { getPrompt } from "#runtime";
+import { createRequire } from "node:module";
+import { sendCustomMessage } from "#messages";
+const require = createRequire(import.meta.url);
+
+const PROMPT = getPrompt("heart.commands");
+const BG_THRESHOLD_MS = 1000;
+
+interface RunningCmd {
+  command: string;
+  abort: AbortController;
+  startTime: number;
+  killedByUser: boolean;
+  context: string;
+}
+
+export function registerProcess(pi: ExtensionAPI) {
+  let nextId = 1;
+  let _lastCmd = "";
+  const running = new Map<number, RunningCmd>();
+
+  pi.on("before_agent_start", async (event) => {
+    try {
+      const active = pi.getActiveTools();
+      if (active.includes("bash")) pi.setActiveTools(active.filter((n: string) => n !== "bash"));
+    } catch {}
+    return { systemPrompt: event.systemPrompt + "\n\n" + PROMPT };
+  });
+
+  pi.registerTool({
+    name: "execute",
+    label: "Execute",
+    messageDescription: "Execute a shell command. Fast commands return immediately. Slow commands auto-background.",
+    promptSnippet: "Execute shell command",
+    parameters: Type.Object({
+      command: Type.String({ messageDescription: "Shell command to execute" }),
+    }),
+    renderCall(args: any, theme: any) {
+      const { Text } = require("@earendil-works/pi-tui");
+      const cmd = args?.command || _lastCmd || "...";
+      return new Text(theme.fg("toolTitle", theme.bold("● Execute ")) + theme.fg("text", cmd), 0, 0);
+    },
+    async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+      const cmd = params.command;
+      _lastCmd = cmd.split("\n")[0].slice(0, 80);
+
+      if (/^\s*sleep\s+[\d.]+\s*$/.test(cmd) || /(^|&&|;|\|)\s*sleep\s+[\d.]+(\s*&&|\s*;|\s*\||$)/.test(cmd)) {
+        return { content: [{ type: "text", text: "Sleep blocked" }], details: { blocked: true }, isError: true };
+      }
+      // NORM-009: 禁写 + execute ls 触发 markLs
+      if (/(>\s+\S|>>\s+\S|tee\s+\S|dd\s+.*\bof=|\bsed\s+.*-i|\bcp\b|\bmv\b|\bmkdir\b|\btouch\b|\brm\b|\bchmod\b|\bchown\b|\bnpx\b|\bnpm\s+(i|install)|\bwget\b|\bcurl\b.*-[oO])/i.test(cmd)) {
+        return { content: [{ type: "text", text: "execute 禁写。用 edit 修改文件，write 创建新文件。" }], details: { blocked: true }, isError: true };
+      }
+      if (/^ls\s+/.test(cmd)) { global.__ls_dir = cmd.replace(/^ls\s+/, "").trim(); }
+
+      const ac = new AbortController();
+      const startTime = Date.now();
+      const execPromise = pi.exec("bash", ["-c", cmd], { signal: ac.signal });
+
+      const race = await Promise.race([
+        execPromise.then(r => ({ done: true as const, result: r })),
+        new Promise<{ done: false }>(resolve => setTimeout(() => resolve({ done: false }), BG_THRESHOLD_MS)),
+      ]);
+
+      if (race.done) {
+        const r = race.result;
+        const output = [r.stdout, r.stderr].filter(Boolean).join("\n").slice(0, 50000);
+        const exitInfo = r.code !== 0 ? `\n(exit ${r.code})` : "";
+        return {
+          content: [{ type: "text", text: `${output || "(no output)"}${exitInfo}` }],
+          details: { exitCode: r.code },
+        };
+      }
+
+      const id = nextId++;
+      let context = "";
+      try {
+        const msgs = _ctx.sessionManager?.getBranch?.() ?? [];
+        const recent = msgs.slice(-5);
+        context = recent.map((e: any) => {
+          const m = e.message ?? e;
+          const role = m.role ?? e.type ?? "?";
+          const text = typeof m.content === "string" ? m.content
+            : Array.isArray(m.content) ? m.content.filter((c: any) => c.type === "text").map((c: any) => c.text).join(" ") : "";
+          return `[${role}] ${text.slice(0, 100)}`;
+        }).filter(Boolean).join("\n");
+      } catch {}
+      running.set(id, { command: cmd, abort: ac, startTime, killedByUser: false, context });
+
+      (async () => {
+        try {
+          const r = await execPromise;
+          const elapsed = Math.round((Date.now() - startTime) / 1000);
+          const output = [r.stdout, r.stderr].filter(Boolean).join("\n").slice(0, 50000);
+          try {
+            pi.sendMessage(
+              { messageType: "continuous-cmd-done", content: `完成 (${elapsed}s, exit ${r.code}):\n$ ${cmd}\n${output || "(no output)"}`, isDisplayedInTUI: false },
+              { deliverAs: "steer", isTriggerNewTurn: true }
+            );
+          } catch {}
+        } catch (err: any) {
+          const elapsed = Math.round((Date.now() - startTime) / 1000);
+          const entry = running.get(id);
+          const msg = entry?.killedByUser
+            ? `Command killed by user (${elapsed}s):\n$ ${cmd}`
+            : `Command failed (${elapsed}s):\n$ ${cmd}\n${err?.message ?? err}`;
+          try { sendCustomMessage(pi, "continuous-cmd-done", msg); } catch {}
+        } finally {
+          running.delete(id);
+        }
+      })();
+
+      return {
+        content: [{ type: "text", text: `Running in background (${running.size} running). Keep working.` }],
+        details: {},
+      };
+    },
+  });
+
+}

package/core/individual.bio.organs/heart.main/process.ts.CHANGELOG

@@ -0,0 +1,2 @@
+[2026-06-15] by Claude Code
+- PROMPT([COMMANDS]/run 工具说明) 改为 getPrompt("heart.commands")，从 coded.dna 取，不再硬编码。

package/core/individual.bio.organs/heart.main/process.ts.SPEC

@@ -0,0 +1,24 @@
+source: process.ts @ 9b1311d4
+
+# process.ts — Background process runner: run tool + /monitor + /restart
+
+## 职责
+Registers the `run` tool for shell command execution with automatic backgrounding: fast commands (<1s) return inline, slow commands auto-background and notify via steer message on completion. Also provides /monitor (view running commands) and /restart (deploy + kill + restart).
+
+## 接口
+- `registerProcess(pi: ExtensionAPI): void` — installs run tool, /monitor, /restart
+
+## 依赖
+- `#runtime` (getPrompt for "heart.commands")
+- `typebox` (Type)
+- `@mariozechner/pi-coding-agent` (ExtensionAPI)
+
+## 行为要点
+- **run tool**: executes via `pi.exec("bash", ["-c", cmd])` with AbortController
+- **Auto-background**: races exec against 1s timeout; fast results return inline, slow ones get tracked in a Map and report completion via messageType "unstop-cmd-done" steer message
+- **sleep blocking**: rejects bare `sleep N` commands (waiting is built-in, sleeping = idle)
+- **Context capture**: stores last 5 messages as context when backgrounding (shown in /monitor)
+- **Output cap**: stdout+stderr truncated to 50KB
+- **/monitor command**: lists running commands with elapsed time, select to preview context
+- **/restart command**: copies dist-override files to pi dist, clears jiti cache, kills all pi-coding-master processes for the person, then exits (hardcoded personId "8cbde57b")
+- Injects "heart.commands" prompt via before_agent_start

package/core/individual.bio.organs/heart.main/remove_timeout.patch

@@ -0,0 +1,110 @@
+--- /tmp/pi-orig/package/dist/core/tools/bash.js	1985-10-26 16:15:00
++++ /opt/homebrew/lib/node_modules/@earendil-works/pi-coding-agent/dist/core/tools/bash.js	2026-06-20 02:02:35
+@@ -13,8 +13,8 @@
+ import { wrapToolDefinition } from "./tool-definition-wrapper.js";
+ import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize } from "./truncate.js";
+ const bashSchema = Type.Object({
+-    command: Type.String({ messageDescription: "Bash command to execute" }),
+-    timeout: Type.Optional(Type.Number({ messageDescription: "Timeout in seconds (optional, no default timeout)" })),
++    command: Type.String({ messageDescription: "BASH command to execute" }),
++
+ });
+ /**
+  * Create bash operations using pi's built-in local shell execution backend.
+@@ -97,7 +97,7 @@
+ }
+ const BASH_PREVIEW_LINES = 5;
+ const BASH_UPDATE_THROTTLE_MS = 100;
+-class BashResultRenderComponent extends Container {
++class BASHResultRenderComponent extends Container {
+     state = {
+         cachedWidth: undefined,
+         cachedLines: undefined,
+@@ -107,14 +107,14 @@
+ function formatDuration(ms) {
+     return `${(ms / 1000).toFixed(1)}s`;
+ }
+-function formatBashCall(args) {
++function formatBASHCall(args) {
+     const command = str(args?.command);
+     const timeout = args?.timeout;
+     const timeoutSuffix = timeout ? theme.fg("muted", ` (timeout ${timeout}s)`) : "";
+     const commandDisplay = command === null ? invalidArgText(theme) : command ? command : theme.fg("toolOutput", "...");
+-    return theme.fg("toolTitle", theme.bold(`$ ${commandDisplay}`)) + timeoutSuffix;
++                return theme.fg("toolTitle", "● " + theme.bold("Bash")) + " " + theme.fg("text", command) + timeoutSuffix;
+ }
+-function rebuildBashResultRenderComponent(component, result, options, showImages, startedAt, endedAt) {
++function rebuildBASHResultRenderComponent(component, result, options, showImages, startedAt, endedAt) {
+     const state = component.state;
+     component.clear();
+     let output = getTextOutput(result, showImages).trim();
+@@ -131,8 +131,8 @@
+             .split("\n")
+             .map((line) => theme.fg("toolOutput", line))
+             .join("\n");
+-        if (options.expanded) {
+-            component.addChild(new Text(`\n${styledOutput}`, 0, 0));
++                if (options.expanded) {
++            component.addChild(new Text(styledOutput, 2, 0));
+         }
+         else {
+             component.addChild({
+@@ -146,9 +146,9 @@
+                     if (state.cachedSkipped && state.cachedSkipped > 0) {
+                         const hint = theme.fg("muted", `... (${state.cachedSkipped} earlier lines,`) +
+                             ` ${keyHint("app.tools.expand", "to expand")}${theme.fg("muted", ")")}`;
+-                        return ["", truncateToWidth(hint, width, "..."), ...(state.cachedLines ?? [])];
++                        return [truncateToWidth(hint, width, "..."), ...(state.cachedLines ?? []).map(l => "  " + l)];
+                     }
+-                    return ["", ...(state.cachedLines ?? [])];
++                    return [...(state.cachedLines ?? []).map(l => "  " + l)];
+                 },
+                 invalidate: () => {
+                     state.cachedWidth = undefined;
+@@ -173,11 +173,7 @@
+         }
+         component.addChild(new Text(`\n${theme.fg("warning", `[${warnings.join(". ")}]`)}`, 0, 0));
+     }
+-    if (startedAt !== undefined) {
+-        const label = options.isPartial ? "Elapsed" : "Took";
+-        const endTime = endedAt ?? Date.now();
+-        component.addChild(new Text(`\n${theme.fg("muted", `${label} ${formatDuration(endTime - startedAt)}`)}`, 0, 0));
+-    }
++    // pi-coding-master: 去掉 "Took/Elapsed Xs" —— 结果行的时间戳 [时:分:秒 +Xs] 已经显示了耗时，这行是重复的（用户嫌）。
+ }
+ export function createBashToolDefinition(cwd, options) {
+     const ops = options?.operations ?? createLocalBashOperations({ shellPath: options?.shellPath });
+@@ -186,10 +182,11 @@
+     return {
+         name: "bash",
+         label: "bash",
+-        messageDescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. Optionally provide a timeout in seconds.`,
++        messageDescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). If truncated, full output is saved to a temp file. For long commands use run() tool.`,
+         promptSnippet: "Execute bash commands (ls, grep, find, etc.)",
+         parameters: bashSchema,
+-        async execute(_toolCallId, { command, timeout }, signal, onUpdate, _ctx) {
++        async execute(_toolCallId, { command }, signal, onUpdate, _ctx) {
++            const timeout = undefined;
+             const resolvedCommand = commandPrefix ? `${commandPrefix}\n${command}` : command;
+             const spawnContext = resolveSpawnContext(resolvedCommand, cwd, spawnHook);
+             const output = new OutputAccumulator({ tempFilePrefix: "pi-bash" });
+@@ -309,7 +306,7 @@
+                 state.endedAt = undefined;
+             }
+             const text = context.lastComponent ?? new Text("", 0, 0);
+-            text.setText(formatBashCall(args));
++            text.setText(formatBASHCall(args));
+             return text;
+         },
+         renderResult(result, options, _theme, context) {
+@@ -324,8 +321,8 @@
+                     state.interval = undefined;
+                 }
+             }
+-            const component = context.lastComponent ?? new BashResultRenderComponent();
+-            rebuildBashResultRenderComponent(component, result, options, context.showImages, state.startedAt, state.endedAt);
++            const component = context.lastComponent ?? new BASHResultRenderComponent();
++            rebuildBASHResultRenderComponent(component, result, options, context.showImages, state.startedAt, state.endedAt);
+             component.invalidate();
+             return component;
+         },

package/core/individual.bio.organs/heart.main/stop.ts.CHANGELOG

@@ -0,0 +1,3 @@
+[2026-06-15] by Claude Code
+- PROMPT([CONTINUOUS AGENT]/wait·hibernate 说明) 改为 getPrompt("heart.continuous")，从 coded.dna 取，不再硬编码。
+[2026-06-15 22:45:52] edited (auto-logged, no messageDescription)

package/core/individual.bio.organs/heart.main/stop.ts.SPEC

@@ -0,0 +1,28 @@
+source: stop.ts @ 9033e8a7
+
+# stop.ts — Continuous/unstop mechanism: wait, hibernate, auto-continue
+
+## 职责
+Implements the "never truly stop" continuous execution loop. Registers wait/hibernate tools and /unstop command. On agent_end, auto-sends a follow-up message to keep the agent alive. Manages hibernate (deep rest, wakeable by user/voice), wait (timed pause with countdown), and Esc hard-stop.
+
+## 接口
+- `registerStop(pi: ExtensionAPI, state: UnstopState): void` — installs all hooks/tools/commands
+- `UnstopState` interface: `{ enabled, maxCount, count, timeLimitMs, startTime }`
+
+## 依赖
+- `#runtime` (getPrompt, getSessionRole)
+- `typebox` (Type), `node:fs`, `node:os`, `node:path`
+- `@mariozechner/pi-coding-agent` (ExtensionAPI)
+
+## 行为要点
+- **wait tool**: pauses 1-30s with countdown UI, then auto-resumes via followUp message; blocks if /wait off
+- **hibernate tool**: stops continuous loop (enabled=false), wakeable by real user/voice input; blocks if /hibernate off
+- **agent_end hook**: auto-continues unless disabled, aborted (Esc), hibernate backoff (<5s), or wait/hibernate tool was last call; errors retry with exponential backoff up to 5min
+- **Esc shortcut**: hard-stop (abort + enabled=false + disabledByUser=true); requires /unstop to resume
+- **Wake detection**: real user message while hibernating re-enables continuous (unless user explicitly disabled)
+- **sleep-done signal**: triggers restart via wake nonce file (if restart loop available) or in-place re-enable
+- **session_start**: resets state, writes PID lock, kills stale main processes, kicks first turn
+- **/unstop command**: on|off|toggle|N (count limit)|Nm (time limit)|Ns
+- **/hibernate, /wait commands**: toggle disable flags via env vars
+- Only main session gets the continuous prompt injection (workers skip)
+- Debug logging to /tmp/unstop-debug.log with process.title for multi-instance disambiguation

package/core/individual.bio.organs/mouth.speak/index.ts

@@ -0,0 +1 @@
+export { default } from "./speak.ts";

package/core/individual.bio.organs/mouth.speak/index.ts.CHANGELOG

@@ -0,0 +1 @@
+[2026-06-15 21:14:29] created

package/core/individual.bio.organs/mouth.speak/index.ts.SPEC

@@ -0,0 +1,6 @@
+source: index.ts @ 11ca5f79
+
+mouth.speak SPEC — 语音合成器官 (Text-to-Speech)
+用户需求: "文字是表现文字，但你也就可以say，把话说出来"
+- /speak <text> → 豆包 TTS (vivi 2.0) 朗读
+- auto-speak: 模型每轮输出后可选自动读出

package/core/individual.bio.organs/mouth.speak/mouth.ts.CHANGELOG

@@ -0,0 +1,15 @@
+[2026-06-15 21:14:13] created
+[2026-06-15 21:21:06] edited (auto-logged, no messageDescription)
+[2026-06-15 21:21:53] edited (auto-logged, no messageDescription)
+[2026-06-15 22:03:36] edited (auto-logged, no messageDescription)
+[2026-06-15 22:03:44] edited (auto-logged, no messageDescription)
+[2026-06-15 22:32:57] edited (auto-logged, no messageDescription)
+[2026-06-15 22:33:06] edited (auto-logged, no messageDescription)
+[2026-06-15 22:33:14] edited (auto-logged, no messageDescription)
+[2026-06-15 22:33:38] edited (auto-logged, no messageDescription)
+[2026-06-15 22:36:39] edited (auto-logged, no messageDescription)
+[2026-06-16 03:58] 用户要求：工具名从 say 改为 mouth，label 从 Say 改为 Mouth
+[2026-06-16 04:05] 修复截断：去除 .slice(0,80)，mouth 显示完整文本不再被砍
+[2026-06-16 03:58:32] edited (auto-logged, no messageDescription)
+[2026-06-16 04:05:20] edited (auto-logged, no messageDescription)
+[2026-06-16 04:06:14] edited (auto-logged, no messageDescription)

package/core/individual.bio.organs/mouth.speak/mouth_recorder.py.CHANGELOG

@@ -0,0 +1 @@
+[2026-06-15 22:03:01] created

package/core/individual.bio.organs/mouth.speak/speak.ts

@@ -0,0 +1,180 @@
+// mouth.speak — 豆包 TTS 发声 (vivi 2.0)
+// mouth 工具 → 出声 + 清爽显示
+// 防重叠锁: speaking=true 时拒绝新请求
+// 耳嘴互斥：说话时 ear 自动静音防回声
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { spawn, type ChildProcess } from "node:child_process";
+import { writeFileSync, unlinkSync } from "node:fs";
+import * as https from "node:https";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { getPrompt } from "#runtime";
+
+const MOUTH_STATE_FILE = join(homedir(), ".pi", "agent", "mouth_state");
+
+const PROMPT = getPrompt("mouth.speak");
+const DOUBAO_APP_ID = process.env.DOUBAO_APP_ID || "";
+const DOUBAO_TOKEN = process.env.DOUBAO_TOKEN || "";
+const TTS_VOICE = "zh_female_vv_uranus_bigtts";
+const TTS_ENDPOINT = "openspeech.bytedance.com";
+const TTS_PATH = "/api/v1/tts";
+
+// 说话队列：后续 mouth 入队按顺序播，绝不丢弃；每段播完/失败/超时都一定收尾→放下一段。
+let speaking = false;
+let speakProc: ChildProcess | null = null;
+let speakQueue: string[] = [];
+let watchdog: ReturnType<typeof setTimeout> | null = null;
+let lastSpokenText = "";
+let lastSpokenAt = 0;
+// /mouth on|off 持久化：存 ~/.pi/agent/mouth_state，重启后保持上次状态
+let mouthOn = (() => { try { return require("node:fs").readFileSync(MOUTH_STATE_FILE, "utf8").trim() === "on"; } catch { return false; } })();
+
+// 一段结束（正常播完 / 合成失败 / 网络错 / 看门狗超时）统一走这里：
+// 解锁、清看门狗，再去放队列里的下一段。保证 speaking 永远会被复位——
+// 不会再卡在 speaking=true 把后续 mouth 全堵死（"不知道自己说完了"的根）。
+function finishCurrent() {
+  if (watchdog) { clearTimeout(watchdog); watchdog = null; }
+  speakProc = null;
+  speaking = false;
+  processQueue();
+}
+
+function processQueue() {
+  if (speaking) return;
+  const text = speakQueue.shift();
+  if (text === undefined) {
+    // 队列空了 = 真的全说完了 → 撤掉静音标记，耳朵恢复监听。
+    try { unlinkSync("/tmp/pi_mouth_speaking"); } catch {}
+    return;
+  }
+  speaking = true;
+  lastSpokenText = text;
+  lastSpokenAt = Date.now();
+  try { writeFileSync("/tmp/pi_mouth_speaking", "1", "utf-8"); } catch {}
+
+  const body = JSON.stringify({
+    app: { appid: DOUBAO_APP_ID, token: DOUBAO_TOKEN, cluster: "volcano_tts" },
+    user: { uid: "pi-mouth" },
+    audio: { voice_type: TTS_VOICE, encoding: "mp3", rate: 24000 },
+    request: { reqid: `${Date.now()}`, text, text_type: "plain", operation: "query" },
+  });
+
+  const req = https.request({
+    hostname: TTS_ENDPOINT, path: TTS_PATH, method: "POST",
+    headers: { Authorization: `Bearer;${DOUBAO_TOKEN}`, "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) },
+    timeout: 15000,
+  }, (res) => {
+    let data = "";
+    res.on("data", (chunk: Buffer) => data += chunk.toString());
+    res.on("end", () => {
+      try {
+        const resp = JSON.parse(data);
+        if (resp.code === 3000 && resp.data) {
+          const mp3 = Buffer.from(resp.data, "base64");
+          writeFileSync("/tmp/pi_mouth.mp3", mp3);
+          // 不再 detached/unref —— 那会让 afplay 的 close 事件不可靠。普通 spawn，close 必触发，
+          // 收尾才稳；进程退出时 session_shutdown 会 kill 掉它。
+          speakProc = spawn("afplay", ["/tmp/pi_mouth.mp3"], { stdio: "ignore" });
+          const thisProc = speakProc;
+          const maxMs = Math.min(180000, 8000 + text.length * 350);
+          watchdog = setTimeout(() => { try { thisProc.kill(); } catch {} if (speakProc === thisProc) finishCurrent(); }, maxMs);
+          thisProc.on("close", () => { if (speakProc === thisProc) finishCurrent(); });
+          thisProc.on("error", () => { if (speakProc === thisProc) finishCurrent(); });
+        } else {
+          finishCurrent(); // 合成失败也要收尾+继续队列，绝不卡死
+        }
+      } catch {
+        finishCurrent();
+      }
+    });
+  });
+  req.on("error", () => finishCurrent());
+  req.on("timeout", () => { try { req.destroy(); } catch {} finishCurrent(); });
+  req.write(body);
+  req.end();
+}
+
+function doSpeak(text: string) {
+  if (!mouthOn) return { content: [{ type: "text", text: "mouth is off (/mouth on to enable)" }], details: {}, isError: true };
+  if (!text || !text.trim()) return;
+  // 防"从头重说"：turn 被打断 / continuous 续命会让模型重发同一句 → 同一段话 10s 内重复就跳过。
+  if (text === lastSpokenText && Date.now() - lastSpokenAt < 10000) return;
+  speakQueue.push(text);   // 关键：后续 mouth 入队，不再被 speaking 锁直接丢掉。
+  processQueue();
+}
+
+export default function (pi: ExtensionAPI) {
+  const _cmds: any[] = [];
+  let personId: string | null = null;
+
+  // 只在主意识 session 启用 mouth。hc/sc/sleep 不需要说话。
+  pi.on("session_start", async (_event, ctx) => {
+    const sf = ctx.sessionManager.getSessionFile();
+    if (!sf) return;
+    if (sf.includes("conscious-sessions") || sf.includes("hippocampus-sessions") || sf.includes("sleep-sessions")) {
+      return;
+    }
+    const m = sf.match(/\.pi\/memory\/([a-f0-9]+)\//);
+    if (!m) return;
+    personId = m[1];
+  });
+
+  // ── mouth 工具：出声 + 清爽显示 ───
+  pi.registerTool({
+    name: "mouth",
+    label: "Mouth (TTS)",
+    messageDescription: "Speak text aloud via 豆包 TTS (vivi 2.0 voice). Ear auto-mutes. Single speech at a time.",
+    promptSnippet: "Speak text aloud via 豆包 TTS (vivi 2.0 voice, clean display)",
+    parameters: {
+      type: "object" as any, properties: {
+        text: { type: "string", messageDescription: "Text to speak aloud." }
+      }, required: ["text"]
+    },
+    // 工具调用本身就渲染成一行清爽的语音(柔和青色,像"说话")——
+    // 不显示"mouth"工具框、不显示结果框。颜色区别于潜意识的黄。
+    renderCall(args: any, _theme: any) {
+      const { Text } = require("@earendil-works/pi-tui");
+      const SPEAK = "\x1b[38;5;116m", RESET = "\x1b[39m";
+      return new Text(SPEAK + "● " + (args?.text ?? "") + RESET, 0, 0); // 普通bullet色,让replaceDot根据状态着色;文字保留语音青色
+    },
+    async execute(_id: string, params: any) {
+      if (!personId) return { content: [], details: {} };
+      const result = doSpeak(params.text as string);
+      if (result && result.isError) return result;
+      return { content: [], details: {} }; // 空结果 → 无结果框；显示交给 renderCall
+    },
+  });
+
+  // (mouth-speak 消息渲染器已去掉：显示改由工具的 renderCall 直接渲染一行，不再发单独消息。)
+
+  // ── /mouth on|off：开关说话（和耳朵 /ears 一样）。off=调 mouth 工具不出声。 ──
+  _cmds.push({
+    name: "body-mouth",
+    desc: "说话开关：/body-mouth on|off。off=不出声（mouth 工具照常调用、只是不合成播放）。",
+    handler: async (args: any, ctx: any) => {
+      const a = (typeof args === "string" ? args : "").trim().toLowerCase();
+      if (a === "off") { mouthOn = false; try { require("node:fs").writeFileSync(MOUTH_STATE_FILE, "off"); } catch {} ctx.ui?.notify?.("mouth off", "info"); }
+      else if (a === "on") { mouthOn = true; try { require("node:fs").writeFileSync(MOUTH_STATE_FILE, "on"); } catch {} ctx.ui?.notify?.("mouth on", "info"); }
+      else ctx.ui?.notify?.(`mouth ${mouthOn ? "on" : "off"}`, "info");
+    },
+  });
+
+  pi.on("before_agent_start", async (event) => {
+    // 只在主意识 session 注入 prompt
+    if (!personId) return;
+    return { systemPrompt: event.systemPrompt + "\n\n" + PROMPT };
+  });
+
+  pi.on("session_shutdown", () => {
+    if (watchdog) { clearTimeout(watchdog); watchdog = null; }
+    if (speakProc) { speakProc.kill(); speakProc = null; }
+    speaking = false;
+    speakQueue = [];
+    try { unlinkSync("/tmp/pi_mouth_speaking"); } catch {}
+  });
+
+  return _cmds;
+}
+
+export { speaking };

package/core/individual.bio.organs/mouth.speak/speak.ts.SPEC

@@ -0,0 +1,3 @@
+source: speak.ts @ c30bbeef
+
+mouth.speak — TTS 语音输出器官。使用豆包 TTS (vivi 2.0) WebSocket 流式合成。支持 /mouth 手动朗读和 /mouth on|off 自动朗读回复。mouth 说话时通过 /tmp/pi_mouth_speaking 标记通知 ear 暂停监听（防回声）。

package/core/individual.bio.organs/mouth.speak/speak_recorder.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""豆包 TTS 语音合成 — body.mouth 后端"""
+
+import json, os, requests, sys, uuid, subprocess
+
+APP_ID = os.environ.get('DOUBAO_APP_ID', '')
+ACCESS_TOKEN = os.environ.get('DOUBAO_TOKEN', '')
+VOICE = 'zh_female_vv_uranus_bigtts'
+API_URL = 'https://openspeech.bytedance.com/api/v1/tts'
+OUTPUT = '/tmp/pi_mouth.mp3'
+MUTE = '/tmp/pi_mouth_speaking'
+
+def tts(text):
+    r = requests.post(API_URL,
+        headers={'Authorization': f'Bearer;{ACCESS_TOKEN}','Content-Type':'application/json'},
+        json={'app':{'appid':APP_ID,'token':ACCESS_TOKEN,'cluster':'volcano_tts'},
+              'user':{'uid':'pi'},'audio':{'voice_type':VOICE,'encoding':'mp3','rate':24000},
+              'request':{'reqid':str(uuid.uuid4()),'text':text,'text_type':'plain','operation':'query'}},
+        timeout=15)
+    if r.status_code == 200 and len(r.content) > 100:
+        with open(OUTPUT,'wb') as f: f.write(r.content)
+        return True
+    print(f'[mouth] TTS({r.status_code})', file=sys.stderr)
+    return False
+
+if __name__ == '__main__':
+    text = sys.argv[1] if len(sys.argv) > 1 else ''
+    if not text.strip(): sys.exit(0)
+    if not tts(text): sys.exit(1)
+    try:
+        with open(MUTE,'w') as f: f.write('1')
+        subprocess.run(['afplay',OUTPUT], check=True, timeout=60)
+    finally:
+        try: os.remove(MUTE)
+        except: pass

package/core/individual.bio.organs/mouth.speak/speak_recorder.py.SPEC

@@ -0,0 +1,3 @@
+source: speak_recorder.py @ 9d2e281a
+
+豆包TTS语音合成脚本：接收文本→调用豆包语音合成2.0 API→保存MP3→写静音标记→播放→清标记。鉴权格式: Bearer;{access_token} + app.token={access_token}。