chatccc 0.2.229 → 0.2.231

package/src/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/response-stall.ts

@@ -1,28 +1,28 @@
-/** A snapshot of visible output progress while the Agent is starting or replying. */
-export interface ResponseProgressObservation {
-  totalChars: number;
-  unchangedSince: number;
-}
-
-/**
- * Tracks how long the displayed output character count has remained unchanged.
- * Leaving a monitored phase clears the window; returning starts a fresh one.
- */
-export function observeResponseProgress(
-  previous: ResponseProgressObservation | undefined,
-  isMonitoredPhase: boolean,
-  totalChars: number,
-  now = Date.now(),
-): ResponseProgressObservation | undefined {
-  if (!isMonitoredPhase) return undefined;
-  if (previous?.totalChars === totalChars) return previous;
-  return { totalChars, unchangedSince: now };
-}
-
-export function hasResponseStalled(
-  observation: ResponseProgressObservation | undefined,
-  now: number,
-  timeoutMs: number,
-): boolean {
-  return observation !== undefined && now - observation.unchangedSince >= timeoutMs;
-}
+/** A snapshot of visible output progress while the Agent is starting or replying. */
+export interface ResponseProgressObservation {
+  totalChars: number;
+  unchangedSince: number;
+}
+
+/**
+ * Tracks how long the displayed output character count has remained unchanged.
+ * Leaving a monitored phase clears the window; returning starts a fresh one.
+ */
+export function observeResponseProgress(
+  previous: ResponseProgressObservation | undefined,
+  isMonitoredPhase: boolean,
+  totalChars: number,
+  now = Date.now(),
+): ResponseProgressObservation | undefined {
+  if (!isMonitoredPhase) return undefined;
+  if (previous?.totalChars === totalChars) return previous;
+  return { totalChars, unchangedSince: now };
+}
+
+export function hasResponseStalled(
+  observation: ResponseProgressObservation | undefined,
+  now: number,
+  timeoutMs: number,
+): boolean {
+  return observation !== undefined && now - observation.unchangedSince >= timeoutMs;
+}

package/src/runtime-reload.ts

@@ -1,34 +1,34 @@
-import {
-  APP_ID,
-  CONFIG_FILE,
-  maskAppId,
-  reloadConfigFromDisk,
-  resolveDefaultAgentTool,
-  type AgentTool,
-} from "./config.ts";
-import { appendStartupTrace } from "./shared.ts";
-import { clearAdapterCache } from "./session.ts";
-import { startChromeDevtoolsGuard } from "./chrome-devtools-guard.ts";
-
-export interface RuntimeReloadResult {
-  configPath: string;
-  defaultAgent: AgentTool;
-  reloadedAt: string;
-}
-
-export function reloadRuntimeConfig(source: string): RuntimeReloadResult {
-  reloadConfigFromDisk();
-  clearAdapterCache();
-  startChromeDevtoolsGuard();
-
-  const result: RuntimeReloadResult = {
-    configPath: CONFIG_FILE,
-    defaultAgent: resolveDefaultAgentTool(),
-    reloadedAt: new Date().toISOString(),
-  };
-  appendStartupTrace(`${source}: config reloaded`, {
-    appIdMask: maskAppId(APP_ID),
-    defaultAgent: result.defaultAgent,
-  });
-  return result;
-}
+import {
+  APP_ID,
+  CONFIG_FILE,
+  maskAppId,
+  reloadConfigFromDisk,
+  resolveDefaultAgentTool,
+  type AgentTool,
+} from "./config.ts";
+import { appendStartupTrace } from "./shared.ts";
+import { clearAdapterCache } from "./session.ts";
+import { startChromeDevtoolsGuard } from "./chrome-devtools-guard.ts";
+
+export interface RuntimeReloadResult {
+  configPath: string;
+  defaultAgent: AgentTool;
+  reloadedAt: string;
+}
+
+export function reloadRuntimeConfig(source: string): RuntimeReloadResult {
+  reloadConfigFromDisk();
+  clearAdapterCache();
+  startChromeDevtoolsGuard();
+
+  const result: RuntimeReloadResult = {
+    configPath: CONFIG_FILE,
+    defaultAgent: resolveDefaultAgentTool(),
+    reloadedAt: new Date().toISOString(),
+  };
+  appendStartupTrace(`${source}: config reloaded`, {
+    appIdMask: maskAppId(APP_ID),
+    defaultAgent: result.defaultAgent,
+  });
+  return result;
+}

package/src/session-chat-binding.ts

@@ -5,8 +5,8 @@
 // 由 session.ts 在初始化时调用 rebuildSessionChatsFromRegistry 重建
 // ---------------------------------------------------------------------------
 
-import type { PlatformAdapter } from "./platform-adapter.ts";
-import type { ResponseProgressObservation } from "./response-stall.ts";
+import type { PlatformAdapter } from "./platform-adapter.ts";
+import type { ResponseProgressObservation } from "./response-stall.ts";
 
 const sessionChatsMap = new Map<string, Set<string>>();
 
@@ -53,51 +53,51 @@ export function hasChatsForSession(sessionId: string): boolean {
   return (sessionChatsMap.get(sessionId)?.size ?? 0) > 0;
 }
 
-// Agent generator 退出后，最终卡片、registry、头像等仍可能在异步收尾。该阶段
-// 也必须阻止下一轮提前进入，否则旧会话的落盘可能覆盖新会话绑定。
-const finalizingSessions = new Set<string>();
-
-// response-stall 自动恢复预约只存在于当前进程内：用户已明确 ChatCCC 重启后
-// 不需要补发恢复 prompt。预约从检测到第一次停滞起一直持有到恢复轮同步进入
-// runAgentSession，填补旧轮收尾和新轮 activePrompts.set 之间的空窗，保证此时
-// 到达的普通用户消息只能进入缓存队列，不能抢在恢复 prompt 前执行。
-const autoRecoveryReservations = new Set<string>();
-
-/** 检查 sessionId 是否有活跃 prompt、正在收尾或已预约自动恢复。 */
-export function isSessionRunning(sessionId: string): boolean {
-  return activePrompts.has(sessionId)
-    || finalizingSessions.has(sessionId)
-    || autoRecoveryReservations.has(sessionId);
-}
-
-export function markSessionFinalizing(sessionId: string): void {
-  finalizingSessions.add(sessionId);
-}
-
-export function clearSessionFinalizing(sessionId: string): void {
-  finalizingSessions.delete(sessionId);
-}
-
-/** 为 response-stall 后的内部恢复轮预留下一次执行权。 */
-export function reserveAutoRecovery(sessionId: string): boolean {
-  if (autoRecoveryReservations.has(sessionId)) return false;
-  autoRecoveryReservations.add(sessionId);
-  return true;
-}
-
-/** 恢复轮启动前原子消费预约；返回 false 表示已被 /stop 取消。 */
-export function consumeAutoRecoveryReservation(sessionId: string): boolean {
-  return autoRecoveryReservations.delete(sessionId);
-}
-
-/** 取消尚未启动的恢复轮。 */
-export function cancelAutoRecoveryReservation(sessionId: string): boolean {
-  return autoRecoveryReservations.delete(sessionId);
-}
-
-export function hasAutoRecoveryReservation(sessionId: string): boolean {
-  return autoRecoveryReservations.has(sessionId);
-}
+// Agent generator 退出后，最终卡片、registry、头像等仍可能在异步收尾。该阶段
+// 也必须阻止下一轮提前进入，否则旧会话的落盘可能覆盖新会话绑定。
+const finalizingSessions = new Set<string>();
+
+// response-stall 自动恢复预约只存在于当前进程内：用户已明确 ChatCCC 重启后
+// 不需要补发恢复 prompt。预约从检测到第一次停滞起一直持有到恢复轮同步进入
+// runAgentSession，填补旧轮收尾和新轮 activePrompts.set 之间的空窗，保证此时
+// 到达的普通用户消息只能进入缓存队列，不能抢在恢复 prompt 前执行。
+const autoRecoveryReservations = new Set<string>();
+
+/** 检查 sessionId 是否有活跃 prompt、正在收尾或已预约自动恢复。 */
+export function isSessionRunning(sessionId: string): boolean {
+  return activePrompts.has(sessionId)
+    || finalizingSessions.has(sessionId)
+    || autoRecoveryReservations.has(sessionId);
+}
+
+export function markSessionFinalizing(sessionId: string): void {
+  finalizingSessions.add(sessionId);
+}
+
+export function clearSessionFinalizing(sessionId: string): void {
+  finalizingSessions.delete(sessionId);
+}
+
+/** 为 response-stall 后的内部恢复轮预留下一次执行权。 */
+export function reserveAutoRecovery(sessionId: string): boolean {
+  if (autoRecoveryReservations.has(sessionId)) return false;
+  autoRecoveryReservations.add(sessionId);
+  return true;
+}
+
+/** 恢复轮启动前原子消费预约；返回 false 表示已被 /stop 取消。 */
+export function consumeAutoRecoveryReservation(sessionId: string): boolean {
+  return autoRecoveryReservations.delete(sessionId);
+}
+
+/** 取消尚未启动的恢复轮。 */
+export function cancelAutoRecoveryReservation(sessionId: string): boolean {
+  return autoRecoveryReservations.delete(sessionId);
+}
+
+export function hasAutoRecoveryReservation(sessionId: string): boolean {
+  return autoRecoveryReservations.has(sessionId);
+}
 
 // ---------------------------------------------------------------------------
 // activePrompts: sessionId → 活跃 prompt 控制
@@ -108,28 +108,28 @@ export interface ActivePrompt {
   stopped: boolean;
   startTime: number;
   /** Root PID for the CLI process currently serving this prompt, if the adapter exposes one. */
-  processPid?: number;
-  processMonitor?: ReturnType<typeof setInterval>;
-  responseStallMonitor?: ReturnType<typeof setInterval>;
-  /** Grace timer that force-closes a stream which stays open after its authoritative final event. */
-  finalResponseCloseTimer?: ReturnType<typeof setTimeout>;
-  /** Character-count progress observed only while the activity is "responding". */
-  responseProgress?: ResponseProgressObservation;
-  /** Set before a response-stall auto-end begins so competing monitors cannot win the race. */
-  autoEnded?: boolean;
-  autoEndedAt?: number;
+  processPid?: number;
+  processMonitor?: ReturnType<typeof setInterval>;
+  responseStallMonitor?: ReturnType<typeof setInterval>;
+  /** Grace timer that force-closes a stream which stays open after its authoritative final event. */
+  finalResponseCloseTimer?: ReturnType<typeof setTimeout>;
+  /** Character-count progress observed only while the activity is "responding". */
+  responseProgress?: ResponseProgressObservation;
+  /** Set before a response-stall auto-end begins so competing monitors cannot win the race. */
+  autoEnded?: boolean;
+  autoEndedAt?: number;
   /** Set when the watchdog detects that the CLI process disappeared before stream finalization. */
   abnormalExit?: boolean;
   abnormalExitNotified?: boolean;
-  /** Set when the resource monitor detects CPU + memory unchanged for 3 minutes. */
-  resourceStuck?: boolean;
-  /** True only for the single internal continuation turn after a response stall. */
-  autoRecovery?: boolean;
-  /** Adapter observed an authoritative completed final-response event. */
-  finalResponseObserved?: boolean;
-  /** Adapter-provided callback to close the underlying SDK session / subprocess.
-   *  Called by stop-stuck-loop before controller.abort() to terminate the CLI
-   *  process immediately, rather than waiting for the async generator to unblock. */
+  /** Set when the resource monitor detects CPU + memory unchanged for 3 minutes. */
+  resourceStuck?: boolean;
+  /** True only for the single internal continuation turn after a response stall. */
+  autoRecovery?: boolean;
+  /** Adapter observed an authoritative completed final-response event. */
+  finalResponseObserved?: boolean;
+  /** Adapter-provided callback to close the underlying SDK session / subprocess.
+   *  Called by stop-stuck-loop before controller.abort() to terminate the CLI
+   *  process immediately, rather than waiting for the async generator to unblock. */
   closeSession?: () => void;
 }
 
@@ -193,10 +193,10 @@ export interface DisplayCardState {
   cardId: string;
   sequence: number;
   cardBusy: boolean;
-  cardCreatedAt: number;
-  lastSentContent: string;
-  /** Last rendered activity header; elapsed time can change without body output. */
-  lastSentHeaderTitle?: string;
+  cardCreatedAt: number;
+  lastSentContent: string;
+  /** Last rendered activity header; elapsed time can change without body output. */
+  lastSentHeaderTitle?: string;
   streamErrorNotified: boolean;
   /** 所属 session */
   sessionId: string;
@@ -209,8 +209,8 @@ export interface DisplayCardState {
   lastSentAccLen?: number;
   /** WeChat delta: 上次发送时的 finalReply */
   lastSentFinalReply?: string;
-  /** Liveness animation counter; the explicit activity header conveys Agent state. */
-  dotCount: number;
+  /** Liveness animation counter; the explicit activity header conveys Agent state. */
+  dotCount: number;
 }
 
 export const displayCards = new Map<string, DisplayCardState>();
@@ -274,18 +274,18 @@ export function consumeQueuedMessage(platform: PlatformAdapter, msg: QueuedMessa
 export function resetBindingState(): void {
   sessionChatsMap.clear();
   lastActiveChatMap.clear();
-  for (const prompt of activePrompts.values()) {
-    if (prompt.processMonitor) clearInterval(prompt.processMonitor);
-    if (prompt.responseStallMonitor) clearInterval(prompt.responseStallMonitor);
-    if (prompt.finalResponseCloseTimer) clearTimeout(prompt.finalResponseCloseTimer);
-  }
-  activePrompts.clear();
-  finalizingSessions.clear();
-  autoRecoveryReservations.clear();
-  queuedMessages.clear();
+  for (const prompt of activePrompts.values()) {
+    if (prompt.processMonitor) clearInterval(prompt.processMonitor);
+    if (prompt.responseStallMonitor) clearInterval(prompt.responseStallMonitor);
+    if (prompt.finalResponseCloseTimer) clearTimeout(prompt.finalResponseCloseTimer);
+  }
+  activePrompts.clear();
+  finalizingSessions.clear();
+  autoRecoveryReservations.clear();
+  queuedMessages.clear();
   displayCards.clear();
   if (unifiedDisplayLoopHandle !== null) {
     clearInterval(unifiedDisplayLoopHandle);
     unifiedDisplayLoopHandle = null;
   }
-}
+}

package/src/session-name.ts

@@ -1,8 +1,8 @@
-export function cwdDisplayName(cwd: string): string {
-  const trimmed = cwd.trim().replace(/[\\/]+$/, "");
-  return trimmed.split(/[\\/]/).filter(Boolean).pop() || trimmed || "cwd";
-}
-
-export function sessionChatName(left: string, cwd: string): string {
-  return `${left}-${cwdDisplayName(cwd)}`;
-}
+export function cwdDisplayName(cwd: string): string {
+  const trimmed = cwd.trim().replace(/[\\/]+$/, "");
+  return trimmed.split(/[\\/]/).filter(Boolean).pop() || trimmed || "cwd";
+}
+
+export function sessionChatName(left: string, cwd: string): string {
+  return `${left}-${cwdDisplayName(cwd)}`;
+}