chatccc 0.2.236 → 0.2.238

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.236",
+  "version": "0.2.238",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/builtin-session-search.test.ts

@@ -210,6 +210,40 @@ describe("searchBuiltinSessions (raw stream logs)", () => {
     expect(enabled.scannedRawLogFiles).toBe(1);
   });
 
+  it("skips truncated/corrupt gzip files without crashing (unexpected end of file)", async () => {
+    // 护栏：线上事故——截断的 gzip 解压报 "unexpected end of file"，若 error 事件
+    // 无人监听会升级为 uncaughtException 杀死整个服务。必须跳过并继续。
+    const contextDir = await mkdtemp(join(tmpdir(), "deepccc-search-raw-trunc-"));
+    const rawLogsDir = await mkdtemp(join(tmpdir(), "deepccc-search-raw-trunc-logs-"));
+    await writeContextSession(contextDir, "trunc", {
+      messages: [{ role: "user", content: "kw-trunc" }],
+    });
+
+    const sessionDir = join(rawLogsDir, "deepccc", "trunc");
+    await mkdir(sessionDir, { recursive: true });
+    const good = gzipSync(JSON.stringify({ type: "text-delta", text: "关键词 kw-good" }));
+    await writeFile(join(sessionDir, "2026-08-04T00-00-00-000Z-a.jsonl.gz"), good, "utf8");
+    // 截断一半：必然触发 zlib unexpected end of file
+    const truncated = gzipSync(JSON.stringify({ type: "text-delta", text: "关键词 kw-trunc-in-gzip" }));
+    await writeFile(join(sessionDir, "2026-08-04T00-00-00-000Z-b.jsonl.gz"), truncated.subarray(0, Math.floor(truncated.length / 2)), "utf8");
+
+    let output;
+    try {
+      output = await searchBuiltinSessions("kw-good", {
+        contextDir,
+        rawLogsDir,
+        includeRawLogs: true,
+      });
+    } catch (err) {
+      // 若损坏 gzip 导致 reject，这里直接断言失败并暴露错误
+      expect.fail(`searchBuiltinSessions 不应 reject: ${String(err)}`);
+    }
+
+    // 好文件正常命中；截断文件被跳过但不崩溃
+    expect(output!.matches.map((m) => m.snippet).join("\n")).toContain("kw-good");
+    expect(output!.scannedRawLogFiles).toBe(2);
+  });
+
   it("ignores missing raw log roots", async () => {
     const contextDir = await mkdtemp(join(tmpdir(), "deepccc-search-raw-missing-"));
     await writeContextSession(contextDir, "s", {

package/src/__tests__/restart.test.ts

@@ -1,232 +1,232 @@
-import { EventEmitter } from "node:events";
-import { mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-import { describe, expect, it, vi, afterEach } from "vitest";
-
-import {
-  buildRestartSpawnSpec,
-  decideRestartParentExit,
-  spawnRestartChild,
-  RESTART_CHILD_READY_MS,
-} from "../orchestrator.ts";
-import { INTERNAL_RESTART_ENV_VAR } from "../startup-lifecycle.ts";
-
-describe("buildRestartSpawnSpec", () => {
-  it("spawns node directly with the local tsx CLI (never via npx/npm)", () => {
-    const spec = buildRestartSpawnSpec("F:/proj");
-    expect(spec.command).toBe(process.execPath);
-    expect(spec.args[0]).toBe(join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"));
-    expect(spec.args[1]).toBe("src/index.ts");
-    expect([spec.command, ...spec.args].join(" ")).not.toMatch(/npx|npm/i);
-  });
-
-  it("accepts the default project root", () => {
-    const spec = buildRestartSpawnSpec();
-    expect(spec.command).toBe(process.execPath);
-    expect(spec.args[0]).toContain("tsx");
-  });
-});
-
-describe("spawnRestartChild", () => {
-  class FakeChild extends EventEmitter {
-    pid = 12345;
-    exitCode: number | null = null;
-    signalCode: number | string | null = null;
-    unref = vi.fn();
-    stderr = new EventEmitter();
-  }
-
-  let tmpDirs: string[] = [];
-  afterEach(async () => {
-    for (const dir of tmpDirs) await rm(dir, { recursive: true, force: true });
-    tmpDirs = [];
-  });
-
-  async function tmpLogDir(): Promise<string> {
-    const dir = await mkdtemp(join(tmpdir(), "chatccc-restart-"));
-    tmpDirs.push(dir);
-    return dir;
-  }
-
-  it("spawns without a shell, redirects stderr to a restart log file, and marks the internal restart env", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    const child = spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
-
-    expect(child).toBe(fake);
-    expect(spawnImpl).toHaveBeenCalledWith(
-      process.execPath,
-      [join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"), "src/index.ts"],
-      expect.objectContaining({
-        detached: true,
-        env: expect.objectContaining({ [INTERNAL_RESTART_ENV_VAR]: "1" }),
-        // 不使用 shell：避免 npm/npx 的 PATH 注入问题
-        shell: false,
-      }),
-    );
-    // spawnImpl 收到的 command/args 中不得出现 npx/npm（env 里的 npm_* 变量不算）
-    const firstCall = spawnImpl.mock.calls[0] as unknown as [string, string[]];
-    const [cmd, args] = firstCall;
-    expect([cmd, ...args].join(" ")).not.toMatch(/npx|npm/i);
-
-    // stderr 指向磁盘日志文件（fd），而不是 pipe：pipe 读端随父进程退出关闭后，
-    // 子进程写 stderr 会 EPIPE 崩溃（飞书 SDK console.warn 崩溃根因）。
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
-    expect(stdio[0]).toBe("ignore");
-    expect(stdio[1]).toBe("ignore");
-    expect(typeof stdio[2]).toBe("number");
-    expect(stdio[2] as number).toBeGreaterThan(2);
-
-    const files = await readdir(logDir);
-    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
-  });
-
-  it("records child exit code/signal in trace without pipe capture", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
-
-    fake.exitCode = 1;
-    fake.emit("exit", 1, null);
-
-    const exitCall = trace.mock.calls.find(([name]) => name === "restart: child exit");
-    expect(exitCall).toBeTruthy();
-    expect(exitCall![1]).toEqual(expect.objectContaining({
-      childPid: 12345,
-      code: 1,
-      signal: null,
-    }));
-    // 不再用 pipe 收集 stderr，trace 里不再有 stderr 字段
-    expect(exitCall![1]).not.toHaveProperty("stderr");
-  });
-
-  it("falls back to pipe capture when the stderr log file cannot be opened", async () => {
-    const dir = await tmpLogDir();
-    // 用普通文件顶替目录：mkdir/open 日志文件必然失败
-    const blocker = join(dir, "blocker");
-    await writeFile(blocker, "x");
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: blocker });
-
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    expect((callArgs[2] as { stdio: unknown[] }).stdio[2]).toBe("pipe");
-    const failCall = trace.mock.calls.find(
-      ([name]) => name === "restart: stderr log open failed, falling back to pipe",
-    );
-    expect(failCall).toBeTruthy();
-    expect(typeof (failCall![1] as { error: unknown }).error).toBe("string");
-  });
-
-  it("inherits the full terminal stdio when launched from a TTY (visible window logs, no EPIPE)", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({
-      projectRoot: "F:/proj",
-      spawnImpl,
-      trace,
-      restartLogDir: logDir,
-      isTty: () => true,
-    });
-
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
-    // 全部 inherit（含 stdin）：避免 detached + stdin=ignore 在 Windows 上
-    // 弹新控制台/丢失控制台关联，日志必须留在用户当前窗口
-    expect(stdio).toEqual(["inherit", "inherit", "inherit"]);
-    // TTY 场景 stderr 走终端，不再生成 restart-*.log 文件
-    const files = await readdir(logDir);
-    expect(files.filter((f) => f.startsWith("restart-") && f.endsWith(".log"))).toHaveLength(0);
-    // 运行时自检 trace：记录 isTty 判定与最终 stdio
-    const spawnCall = trace.mock.calls.find(([name]) => name === "restart: spawn child");
-    expect(spawnCall).toBeTruthy();
-    expect(spawnCall![1]).toEqual({
-      isTty: true,
-      stdio: JSON.stringify(["inherit", "inherit", "inherit"]),
-    });
-  });
-
-  it("still redirects stderr to a file when explicitly not a TTY", async () => {
-    const logDir = await tmpLogDir();
-    const fake = new FakeChild();
-    const spawnImpl = vi.fn(() => fake as never);
-    const trace = vi.fn();
-
-    spawnRestartChild({
-      projectRoot: "F:/proj",
-      spawnImpl,
-      trace,
-      restartLogDir: logDir,
-      isTty: () => false,
-    });
-
-    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
-    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
-    expect(stdio[0]).toBe("ignore");
-    expect(stdio[1]).toBe("ignore");
-    expect(typeof stdio[2]).toBe("number");
-    expect(stdio[2] as number).toBeGreaterThan(2);
-    const files = await readdir(logDir);
-    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
-  });
-});
-
-describe("decideRestartParentExit", () => {
-  it("returns false (parent stays alive) when the child dies during the window", async () => {
-    const child = { exitCode: 1, signalCode: null, pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 200, 50, trace);
-
-    expect(shouldExit).toBe(false);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child died during window, keeping parent",
-      expect.objectContaining({ childPid: 42, exitCode: 1 }),
-    );
-  });
-
-  it("returns true (parent exits) when the child stays alive through the window", async () => {
-    const child = { exitCode: null, signalCode: null, pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 150, 30, trace);
-
-    expect(shouldExit).toBe(true);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child alive after window, parent exiting",
-      expect.objectContaining({ childPid: 42 }),
-    );
-  });
-
-  it("surfaces a child that died with a signal", async () => {
-    const child = { exitCode: null, signalCode: "SIGKILL", pid: 42 } as never;
-    const trace = vi.fn();
-
-    const shouldExit = await decideRestartParentExit(child, 100, 25, trace);
-
-    expect(shouldExit).toBe(false);
-    expect(trace).toHaveBeenCalledWith(
-      "restart: child died during window, keeping parent",
-      expect.objectContaining({ signalCode: "SIGKILL" }),
-    );
-  });
-
-  it("exports a sane default readiness window", () => {
-    expect(RESTART_CHILD_READY_MS).toBeGreaterThan(0);
-    expect(RESTART_CHILD_READY_MS).toBeLessThan(60_000);
-  });
-});
+import { EventEmitter } from "node:events";
+import { mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { describe, expect, it, vi, afterEach } from "vitest";
+
+import {
+  buildRestartSpawnSpec,
+  decideRestartParentExit,
+  spawnRestartChild,
+  RESTART_CHILD_READY_MS,
+} from "../orchestrator.ts";
+import { INTERNAL_RESTART_ENV_VAR } from "../startup-lifecycle.ts";
+
+describe("buildRestartSpawnSpec", () => {
+  it("spawns node directly with the local tsx CLI (never via npx/npm)", () => {
+    const spec = buildRestartSpawnSpec("F:/proj");
+    expect(spec.command).toBe(process.execPath);
+    expect(spec.args[0]).toBe(join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"));
+    expect(spec.args[1]).toBe("src/index.ts");
+    expect([spec.command, ...spec.args].join(" ")).not.toMatch(/npx|npm/i);
+  });
+
+  it("accepts the default project root", () => {
+    const spec = buildRestartSpawnSpec();
+    expect(spec.command).toBe(process.execPath);
+    expect(spec.args[0]).toContain("tsx");
+  });
+});
+
+describe("spawnRestartChild", () => {
+  class FakeChild extends EventEmitter {
+    pid = 12345;
+    exitCode: number | null = null;
+    signalCode: number | string | null = null;
+    unref = vi.fn();
+    stderr = new EventEmitter();
+  }
+
+  let tmpDirs: string[] = [];
+  afterEach(async () => {
+    for (const dir of tmpDirs) await rm(dir, { recursive: true, force: true });
+    tmpDirs = [];
+  });
+
+  async function tmpLogDir(): Promise<string> {
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-restart-"));
+    tmpDirs.push(dir);
+    return dir;
+  }
+
+  it("spawns without a shell, redirects stderr to a restart log file, and marks the internal restart env", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    const child = spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
+
+    expect(child).toBe(fake);
+    expect(spawnImpl).toHaveBeenCalledWith(
+      process.execPath,
+      [join("F:/proj", "node_modules", "tsx", "dist", "cli.mjs"), "src/index.ts"],
+      expect.objectContaining({
+        detached: true,
+        env: expect.objectContaining({ [INTERNAL_RESTART_ENV_VAR]: "1" }),
+        // 不使用 shell：避免 npm/npx 的 PATH 注入问题
+        shell: false,
+      }),
+    );
+    // spawnImpl 收到的 command/args 中不得出现 npx/npm（env 里的 npm_* 变量不算）
+    const firstCall = spawnImpl.mock.calls[0] as unknown as [string, string[]];
+    const [cmd, args] = firstCall;
+    expect([cmd, ...args].join(" ")).not.toMatch(/npx|npm/i);
+
+    // stderr 指向磁盘日志文件（fd），而不是 pipe：pipe 读端随父进程退出关闭后，
+    // 子进程写 stderr 会 EPIPE 崩溃（飞书 SDK console.warn 崩溃根因）。
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
+    expect(stdio[0]).toBe("ignore");
+    expect(stdio[1]).toBe("ignore");
+    expect(typeof stdio[2]).toBe("number");
+    expect(stdio[2] as number).toBeGreaterThan(2);
+
+    const files = await readdir(logDir);
+    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
+  });
+
+  it("records child exit code/signal in trace without pipe capture", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: logDir });
+
+    fake.exitCode = 1;
+    fake.emit("exit", 1, null);
+
+    const exitCall = trace.mock.calls.find(([name]) => name === "restart: child exit");
+    expect(exitCall).toBeTruthy();
+    expect(exitCall![1]).toEqual(expect.objectContaining({
+      childPid: 12345,
+      code: 1,
+      signal: null,
+    }));
+    // 不再用 pipe 收集 stderr，trace 里不再有 stderr 字段
+    expect(exitCall![1]).not.toHaveProperty("stderr");
+  });
+
+  it("falls back to pipe capture when the stderr log file cannot be opened", async () => {
+    const dir = await tmpLogDir();
+    // 用普通文件顶替目录：mkdir/open 日志文件必然失败
+    const blocker = join(dir, "blocker");
+    await writeFile(blocker, "x");
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({ projectRoot: "F:/proj", spawnImpl, trace, restartLogDir: blocker });
+
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    expect((callArgs[2] as { stdio: unknown[] }).stdio[2]).toBe("pipe");
+    const failCall = trace.mock.calls.find(
+      ([name]) => name === "restart: stderr log open failed, falling back to pipe",
+    );
+    expect(failCall).toBeTruthy();
+    expect(typeof (failCall![1] as { error: unknown }).error).toBe("string");
+  });
+
+  it("inherits the full terminal stdio when launched from a TTY (visible window logs, no EPIPE)", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({
+      projectRoot: "F:/proj",
+      spawnImpl,
+      trace,
+      restartLogDir: logDir,
+      isTty: () => true,
+    });
+
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
+    // 全部 inherit（含 stdin）：避免 detached + stdin=ignore 在 Windows 上
+    // 弹新控制台/丢失控制台关联，日志必须留在用户当前窗口
+    expect(stdio).toEqual(["inherit", "inherit", "inherit"]);
+    // TTY 场景 stderr 走终端，不再生成 restart-*.log 文件
+    const files = await readdir(logDir);
+    expect(files.filter((f) => f.startsWith("restart-") && f.endsWith(".log"))).toHaveLength(0);
+    // 运行时自检 trace：记录 isTty 判定与最终 stdio
+    const spawnCall = trace.mock.calls.find(([name]) => name === "restart: spawn child");
+    expect(spawnCall).toBeTruthy();
+    expect(spawnCall![1]).toEqual({
+      isTty: true,
+      stdio: JSON.stringify(["inherit", "inherit", "inherit"]),
+    });
+  });
+
+  it("still redirects stderr to a file when explicitly not a TTY", async () => {
+    const logDir = await tmpLogDir();
+    const fake = new FakeChild();
+    const spawnImpl = vi.fn(() => fake as never);
+    const trace = vi.fn();
+
+    spawnRestartChild({
+      projectRoot: "F:/proj",
+      spawnImpl,
+      trace,
+      restartLogDir: logDir,
+      isTty: () => false,
+    });
+
+    const callArgs = spawnImpl.mock.calls[0] as unknown as Array<unknown>;
+    const stdio = (callArgs[2] as { stdio: unknown[] }).stdio;
+    expect(stdio[0]).toBe("ignore");
+    expect(stdio[1]).toBe("ignore");
+    expect(typeof stdio[2]).toBe("number");
+    expect(stdio[2] as number).toBeGreaterThan(2);
+    const files = await readdir(logDir);
+    expect(files.some((f) => f.startsWith("restart-") && f.endsWith(".log"))).toBe(true);
+  });
+});
+
+describe("decideRestartParentExit", () => {
+  it("returns false (parent stays alive) when the child dies during the window", async () => {
+    const child = { exitCode: 1, signalCode: null, pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 200, 50, trace);
+
+    expect(shouldExit).toBe(false);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child died during window, keeping parent",
+      expect.objectContaining({ childPid: 42, exitCode: 1 }),
+    );
+  });
+
+  it("returns true (parent exits) when the child stays alive through the window", async () => {
+    const child = { exitCode: null, signalCode: null, pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 150, 30, trace);
+
+    expect(shouldExit).toBe(true);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child alive after window, parent exiting",
+      expect.objectContaining({ childPid: 42 }),
+    );
+  });
+
+  it("surfaces a child that died with a signal", async () => {
+    const child = { exitCode: null, signalCode: "SIGKILL", pid: 42 } as never;
+    const trace = vi.fn();
+
+    const shouldExit = await decideRestartParentExit(child, 100, 25, trace);
+
+    expect(shouldExit).toBe(false);
+    expect(trace).toHaveBeenCalledWith(
+      "restart: child died during window, keeping parent",
+      expect.objectContaining({ signalCode: "SIGKILL" }),
+    );
+  });
+
+  it("exports a sane default readiness window", () => {
+    expect(RESTART_CHILD_READY_MS).toBeGreaterThan(0);
+    expect(RESTART_CHILD_READY_MS).toBeLessThan(60_000);
+  });
+});

package/src/__tests__/session.test.ts

@@ -131,9 +131,11 @@ import {
   stopUnifiedDisplayLoop,
   _setProcessAliveForTest,
   _resetProcessAliveForTest,
-  _setProcessMonitorIntervalForTest,
-  _resetProcessMonitorIntervalForTest,
-  _setResponseStallTimeoutForTest,
+  _setProcessMonitorIntervalForTest,
+  _resetProcessMonitorIntervalForTest,
+  _setAvatarRefreshIntervalForTest,
+  _resetAvatarRefreshIntervalForTest,
+  _setResponseStallTimeoutForTest,
   _resetResponseStallTimeoutForTest,
   _setResponseStallCheckIntervalForTest,
   _resetResponseStallCheckIntervalForTest,
@@ -436,7 +438,7 @@ describe("runAgentSession previous final delivery guard", () => {
   });
 });
 
-describe("runAgentSession process monitor", () => {
+describe("runAgentSession process monitor", () => {
   let registryFile = "";
   let toolsFile = "";
 
@@ -804,7 +806,99 @@ describe("runAgentSession process monitor", () => {
     expect(sentTexts[0]).toContain("first prompt");
     expect(sentTexts[1]).toContain("second prompt");
   });
-});
+});
+
+describe("runAgentSession periodic avatar refresh", () => {
+  let registryFile = "";
+  let toolsFile = "";
+
+  beforeEach(async () => {
+    vi.useFakeTimers();
+    resetState();
+    resetBindingState();
+    mockStreamStates.clear();
+    const dir = await mkdtemp(join(tmpdir(), "chatccc-avatar-refresh-"));
+    registryFile = join(dir, "session-registry.json");
+    toolsFile = join(dir, "session-tools.json");
+    _setSessionRegistryFileForTest(registryFile);
+    _setSessionToolsFileForTest(toolsFile);
+    _setAvatarRefreshIntervalForTest(50);
+  });
+
+  afterEach(async () => {
+    _resetSessionRegistryFileForTest();
+    _resetSessionToolsFileForTest();
+    _resetAvatarRefreshIntervalForTest();
+    _clearAdapterCacheForTest();
+    resetState();
+    resetBindingState();
+    vi.useRealTimers();
+    if (registryFile) await rm(dirname(registryFile), { recursive: true, force: true });
+  });
+
+  it.each(["codex", "cursor", "claude", "ccc"])(
+    "refreshes the busy avatar for %s every interval and stops after completion",
+    async (tool) => {
+      const sessionId = `sid-avatar-${tool}`;
+      const chatId = `chat-avatar-${tool}`;
+      const platform = mockPlatform("feishu");
+      setSessionPlatform(platform);
+      bindChatToSession(sessionId, chatId);
+      recordLastActiveChat(sessionId, chatId);
+
+      let finishPrompt: (() => void) | undefined;
+      const adapter: ToolAdapter = {
+        displayName: tool,
+        sessionDescPrefix: `${tool} Session:`,
+        createSession: async () => ({ sessionId }),
+        getSessionInfo: async (sid) => ({ sessionId: sid, cwd: "/tmp" }),
+        closeSession: async () => {},
+        prompt: async function* () {
+          yield { type: "assistant", blocks: [{ type: "text", text: "working" }] };
+          await new Promise<void>((resolve) => {
+            finishPrompt = resolve;
+          });
+          yield { type: "assistant", blocks: [{ type: "text", text: "done" }] };
+        },
+      };
+      _setAdapterForToolForTest(tool, adapter);
+
+      const runPromise = runAgentSession(
+        sessionId,
+        "prompt",
+        platform,
+        chatId,
+        Date.now(),
+        tool,
+      );
+
+      await vi.waitFor(() => {
+        expect(vi.mocked(platform.setChatAvatar).mock.calls.some(
+          ([calledChatId, calledTool, status]) =>
+            calledChatId === chatId && calledTool === tool && status === "busy",
+        )).toBe(true);
+        expect(finishPrompt).toBeTypeOf("function");
+      });
+      const initialBusyCalls = vi.mocked(platform.setChatAvatar).mock.calls.filter(
+        ([calledChatId, calledTool, status]) =>
+          calledChatId === chatId && calledTool === tool && status === "busy",
+      ).length;
+
+      await vi.advanceTimersByTimeAsync(51);
+      expect(vi.mocked(platform.setChatAvatar).mock.calls.filter(
+        ([calledChatId, calledTool, status]) =>
+          calledChatId === chatId && calledTool === tool && status === "busy",
+      )).toHaveLength(initialBusyCalls + 1);
+
+      finishPrompt?.();
+      await runPromise;
+      const callsAfterCompletion = vi.mocked(platform.setChatAvatar).mock.calls.length;
+
+      await vi.advanceTimersByTimeAsync(100);
+      expect(platform.setChatAvatar).toHaveBeenCalledTimes(callsAfterCompletion);
+    },
+  );
+});
 
 describe("runAgentSession response stall watchdog", () => {
   let tempDir = "";