chatccc 0.2.231 → 0.2.232

package/src/builtin/progress/view.ts

@@ -1,77 +1,77 @@
-/**
- * progress/view.ts — 平台无关的"过程进度"视图模型
- *
- * 这是飞书过程卡片与终端过程区块共享的唯一数据模型：
- *  - 飞书：buildProgressCard(view) 把 ProgressView 渲染为卡片 JSON
- *  - 终端：TerminalProgressRenderer 把 ProgressView 渲染为 ANSI 区块
- *  - 事件流：reduceProgress(prev, event) 把 ChatEvent 增量合并进 ProgressView
- *
- * 语义与飞书卡片对齐：
- *  - headerTitle 是"生成中"阶段展示的标题（如"正在启动 Agent · 0秒"）
- *  - status 决定终态外观（完成 / 已停止 / 异常结束）
- *  - text 是正文累积（对应卡片 main_content / 终端区块正文）
- *  - tools 是本轮工具调用列表（飞书卡片暂不展示，终端折叠为单行）
- */
-
-export type ProgressStatus = "generating" | "done" | "stopped" | "error";
-
-export type ProgressToolStatus = "running" | "ok" | "error";
-
-export interface ProgressToolCall {
-  /** 工具调用 ID（ChatEvent.tool_use.id，可能缺失） */
-  id: string;
-  /** 工具名，如 edit_file */
-  name: string;
-  status: ProgressToolStatus;
-  /** 工具输入摘要（终端折叠行展示，截断保存） */
-  detail?: string;
-  /** 工具结果摘要（成功/失败，截断保存） */
-  summary?: string;
-}
-
-export interface ProgressView {
-  /** 当前阶段状态，决定终态外观 */
-  status: ProgressStatus;
-  /** 生成中阶段的头部标题（对应飞书卡片 header title） */
-  headerTitle: string;
-  /** 卡片头部颜色模板（飞书用），终端忽略 */
-  headerTemplate: string;
-  /** 正文累积内容 */
-  text: string;
-  /** 本轮工具调用列表 */
-  tools: ProgressToolCall[];
-  /** 是否展示停止按钮 / 停止提示 */
-  showStop: boolean;
-  /** 最近一次更新时间戳 */
-  updatedAt: number;
-}
-
-export interface ProgressViewInit {
-  status?: ProgressStatus;
-  headerTitle?: string;
-  headerTemplate?: string;
-  text?: string;
-  tools?: ProgressToolCall[];
-  showStop?: boolean;
-}
-
-/** 创建 ProgressView，未提供的字段使用与飞书 buildProgressCard 一致的默认值 */
-export function progressView(init: ProgressViewInit = {}): ProgressView {
-  return {
-    status: init.status ?? "generating",
-    headerTitle: init.headerTitle ?? "生成中...",
-    headerTemplate: init.headerTemplate ?? "blue",
-    text: init.text ?? "",
-    tools: init.tools ?? [],
-    showStop: init.showStop ?? true,
-    updatedAt: Date.now(),
-  };
-}
-
-/** 只读浅拷贝并覆盖部分字段，返回新视图（reducer 的不可变更新用） */
-export function withProgressView(
-  prev: ProgressView,
-  patch: Partial<ProgressView>,
-): ProgressView {
-  return { ...prev, ...patch, updatedAt: Date.now() };
-}
+/**
+ * progress/view.ts — 平台无关的"过程进度"视图模型
+ *
+ * 这是飞书过程卡片与终端过程区块共享的唯一数据模型：
+ *  - 飞书：buildProgressCard(view) 把 ProgressView 渲染为卡片 JSON
+ *  - 终端：TerminalProgressRenderer 把 ProgressView 渲染为 ANSI 区块
+ *  - 事件流：reduceProgress(prev, event) 把 ChatEvent 增量合并进 ProgressView
+ *
+ * 语义与飞书卡片对齐：
+ *  - headerTitle 是"生成中"阶段展示的标题（如"正在启动 Agent · 0秒"）
+ *  - status 决定终态外观（完成 / 已停止 / 异常结束）
+ *  - text 是正文累积（对应卡片 main_content / 终端区块正文）
+ *  - tools 是本轮工具调用列表（飞书卡片暂不展示，终端折叠为单行）
+ */
+
+export type ProgressStatus = "generating" | "done" | "stopped" | "error";
+
+export type ProgressToolStatus = "running" | "ok" | "error";
+
+export interface ProgressToolCall {
+  /** 工具调用 ID（ChatEvent.tool_use.id，可能缺失） */
+  id: string;
+  /** 工具名，如 edit_file */
+  name: string;
+  status: ProgressToolStatus;
+  /** 工具输入摘要（终端折叠行展示，截断保存） */
+  detail?: string;
+  /** 工具结果摘要（成功/失败，截断保存） */
+  summary?: string;
+}
+
+export interface ProgressView {
+  /** 当前阶段状态，决定终态外观 */
+  status: ProgressStatus;
+  /** 生成中阶段的头部标题（对应飞书卡片 header title） */
+  headerTitle: string;
+  /** 卡片头部颜色模板（飞书用），终端忽略 */
+  headerTemplate: string;
+  /** 正文累积内容 */
+  text: string;
+  /** 本轮工具调用列表 */
+  tools: ProgressToolCall[];
+  /** 是否展示停止按钮 / 停止提示 */
+  showStop: boolean;
+  /** 最近一次更新时间戳 */
+  updatedAt: number;
+}
+
+export interface ProgressViewInit {
+  status?: ProgressStatus;
+  headerTitle?: string;
+  headerTemplate?: string;
+  text?: string;
+  tools?: ProgressToolCall[];
+  showStop?: boolean;
+}
+
+/** 创建 ProgressView，未提供的字段使用与飞书 buildProgressCard 一致的默认值 */
+export function progressView(init: ProgressViewInit = {}): ProgressView {
+  return {
+    status: init.status ?? "generating",
+    headerTitle: init.headerTitle ?? "生成中...",
+    headerTemplate: init.headerTemplate ?? "blue",
+    text: init.text ?? "",
+    tools: init.tools ?? [],
+    showStop: init.showStop ?? true,
+    updatedAt: Date.now(),
+  };
+}
+
+/** 只读浅拷贝并覆盖部分字段，返回新视图（reducer 的不可变更新用） */
+export function withProgressView(
+  prev: ProgressView,
+  patch: Partial<ProgressView>,
+): ProgressView {
+  return { ...prev, ...patch, updatedAt: Date.now() };
+}

package/src/builtin/raw-stream-log.ts

@@ -1,124 +1,124 @@
-import { createWriteStream, type Dirent } from "node:fs";
-import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
-import { once } from "node:events";
-import { join } from "node:path";
-import { createGzip } from "node:zlib";
-
-export interface RawStreamLogOptions {
-  enabled: boolean;
-  rootDir: string;
-  tool: string;
-  sessionId: string;
-  label: string;
-  maxBytesPerTurn: number;
-  retentionDays: number;
-}
-
-export interface RawStreamLogHandle {
-  filePath: string;
-  writeLine(line: string): void;
-  close(options: { keep: boolean }): Promise<void>;
-}
-
-export function sanitizeLogPathSegment(value: string): string {
-  const safe = value.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^[._]+|_+$/g, "");
-  return safe || "unknown";
-}
-
-async function cleanupOldRawStreamLogs(rootDir: string, retentionDays: number): Promise<void> {
-  if (!Number.isFinite(retentionDays) || retentionDays <= 0) return;
-  const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
-
-  const visit = async (dir: string): Promise<void> => {
-    let entries: Dirent[];
-    try {
-      entries = await readdir(dir, { withFileTypes: true });
-    } catch {
-      return;
-    }
-
-    await Promise.all(entries.map(async (entry) => {
-      const path = join(dir, entry.name);
-      if (entry.isDirectory()) {
-        await visit(path);
-        try {
-          await rm(path, { recursive: false });
-        } catch {
-          // Directory is not empty or already gone.
-        }
-        return;
-      }
-
-      if (!entry.isFile()) return;
-      try {
-        const info = await stat(path);
-        if (info.mtimeMs < cutoff) await rm(path, { force: true });
-      } catch {
-        // Best-effort cleanup only.
-      }
-    }));
-  };
-
-  await visit(rootDir);
-}
-
-export async function createRawStreamLog(options: RawStreamLogOptions): Promise<RawStreamLogHandle | null> {
-  if (!options.enabled) return null;
-
-  const maxBytes = Math.max(0, Math.floor(options.maxBytesPerTurn));
-  const tool = sanitizeLogPathSegment(options.tool);
-  const session = sanitizeLogPathSegment(options.sessionId);
-  const label = sanitizeLogPathSegment(options.label);
-  const dir = join(options.rootDir, tool, session);
-  await mkdir(dir, { recursive: true });
-  void cleanupOldRawStreamLogs(join(options.rootDir, tool), options.retentionDays);
-
-  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const filePath = join(dir, `${timestamp}-${label}.jsonl.gz`);
-  const output = createWriteStream(filePath);
-  const gzip = createGzip();
-  gzip.pipe(output);
-
-  let bytes = 0;
-  let truncated = false;
-  let ended = false;
-
-  const writeLine = (line: string): void => {
-    if (ended || truncated) return;
-    const payload = `${line}\n`;
-    const payloadBytes = Buffer.byteLength(payload, "utf-8");
-    if (maxBytes > 0 && bytes + payloadBytes > maxBytes) {
-      const marker = JSON.stringify({
-        type: "deepccc_raw_stream_log_truncated",
-        reason: "max_bytes_per_turn_exceeded",
-        maxBytesPerTurn: maxBytes,
-        writtenBytes: bytes,
-      });
-      gzip.write(`${marker}\n`);
-      truncated = true;
-      return;
-    }
-    bytes += payloadBytes;
-    gzip.write(payload);
-  };
-
-  const close = async ({ keep }: { keep: boolean }): Promise<void> => {
-    if (ended) return;
-    ended = true;
-    gzip.end();
-    try {
-      await once(output, "finish");
-    } catch {
-      // Ignore close errors; caller cannot recover from debug log failures.
-    }
-    if (!keep) {
-      try {
-        await unlink(filePath);
-      } catch {
-        // Best-effort cleanup only.
-      }
-    }
-  };
-
-  return { filePath, writeLine, close };
-}
+import { createWriteStream, type Dirent } from "node:fs";
+import { mkdir, readdir, rm, stat, unlink } from "node:fs/promises";
+import { once } from "node:events";
+import { join } from "node:path";
+import { createGzip } from "node:zlib";
+
+export interface RawStreamLogOptions {
+  enabled: boolean;
+  rootDir: string;
+  tool: string;
+  sessionId: string;
+  label: string;
+  maxBytesPerTurn: number;
+  retentionDays: number;
+}
+
+export interface RawStreamLogHandle {
+  filePath: string;
+  writeLine(line: string): void;
+  close(options: { keep: boolean }): Promise<void>;
+}
+
+export function sanitizeLogPathSegment(value: string): string {
+  const safe = value.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^[._]+|_+$/g, "");
+  return safe || "unknown";
+}
+
+async function cleanupOldRawStreamLogs(rootDir: string, retentionDays: number): Promise<void> {
+  if (!Number.isFinite(retentionDays) || retentionDays <= 0) return;
+  const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+
+  const visit = async (dir: string): Promise<void> => {
+    let entries: Dirent[];
+    try {
+      entries = await readdir(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+
+    await Promise.all(entries.map(async (entry) => {
+      const path = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        await visit(path);
+        try {
+          await rm(path, { recursive: false });
+        } catch {
+          // Directory is not empty or already gone.
+        }
+        return;
+      }
+
+      if (!entry.isFile()) return;
+      try {
+        const info = await stat(path);
+        if (info.mtimeMs < cutoff) await rm(path, { force: true });
+      } catch {
+        // Best-effort cleanup only.
+      }
+    }));
+  };
+
+  await visit(rootDir);
+}
+
+export async function createRawStreamLog(options: RawStreamLogOptions): Promise<RawStreamLogHandle | null> {
+  if (!options.enabled) return null;
+
+  const maxBytes = Math.max(0, Math.floor(options.maxBytesPerTurn));
+  const tool = sanitizeLogPathSegment(options.tool);
+  const session = sanitizeLogPathSegment(options.sessionId);
+  const label = sanitizeLogPathSegment(options.label);
+  const dir = join(options.rootDir, tool, session);
+  await mkdir(dir, { recursive: true });
+  void cleanupOldRawStreamLogs(join(options.rootDir, tool), options.retentionDays);
+
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const filePath = join(dir, `${timestamp}-${label}.jsonl.gz`);
+  const output = createWriteStream(filePath);
+  const gzip = createGzip();
+  gzip.pipe(output);
+
+  let bytes = 0;
+  let truncated = false;
+  let ended = false;
+
+  const writeLine = (line: string): void => {
+    if (ended || truncated) return;
+    const payload = `${line}\n`;
+    const payloadBytes = Buffer.byteLength(payload, "utf-8");
+    if (maxBytes > 0 && bytes + payloadBytes > maxBytes) {
+      const marker = JSON.stringify({
+        type: "deepccc_raw_stream_log_truncated",
+        reason: "max_bytes_per_turn_exceeded",
+        maxBytesPerTurn: maxBytes,
+        writtenBytes: bytes,
+      });
+      gzip.write(`${marker}\n`);
+      truncated = true;
+      return;
+    }
+    bytes += payloadBytes;
+    gzip.write(payload);
+  };
+
+  const close = async ({ keep }: { keep: boolean }): Promise<void> => {
+    if (ended) return;
+    ended = true;
+    gzip.end();
+    try {
+      await once(output, "finish");
+    } catch {
+      // Ignore close errors; caller cannot recover from debug log failures.
+    }
+    if (!keep) {
+      try {
+        await unlink(filePath);
+      } catch {
+        // Best-effort cleanup only.
+      }
+    }
+  };
+
+  return { filePath, writeLine, close };
+}