chatccc 0.2.224 → 0.2.226

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/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;
   }
-}
+}