@foxden-app/foxclaw 0.5.42 → 0.5.44

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.5.44 - 2026-06-18
+
+### 中文
+- 修复 Codex 真实 `final_answer` phase 在标准化后变成 `finalanswer`、却未被识别为最终答复的问题；该错误会导致 `0.5.43` 的过程汇报折叠逻辑误判“本轮没有最终答复”并直接跳过。
+- 增加真实 phase 分类回归测试，确保最终答复与 commentary 过程汇报正确分离。
+
+### English
+- Fixed classification of Codex's real `final_answer` phase, which normalizes to `finalanswer` but was not recognized as a final response; this caused the `0.5.43` progress-collapse path to incorrectly skip turns as having no final answer.
+- Added a regression test for the real phase value so final responses remain distinct from commentary updates.
+
+## 0.5.43 - 2026-06-18
+
+### 中文
+- Codex 最终答复出现后，FoxClaw 会把本轮所有过程汇报合并到第一条过程消息，并编辑为默认收起的 Telegram RichMessage `details`；最终答复继续独立展示，使历史记录保持清晰的一问一答结构。
+- 折叠摘要显示过程条数和整体起止时间，展开后每段过程汇报保留精确到秒的起止时间及原有 Markdown 富文本效果；普通 Telegram 回合和 CLI 观察回合统一生效。
+- 如果 RichMessage 编辑失败，原过程消息全部保留且不执行删除；超出 Telegram 单条富消息上限时会明确标注未收入归档的条数。
+
+### English
+- After a Codex final answer arrives, FoxClaw consolidates all progress updates from the turn into the first progress message and edits it into a collapsed Telegram RichMessage `details` block; the final answer remains separate for a clean question-and-answer history.
+- The collapsed summary shows the update count and overall time range, while each expanded update preserves second-level start/end timestamps and Markdown-rich rendering; this applies to both normal Telegram turns and CLI-observed turns.
+- If RichMessage editing fails, every original progress message is preserved and no deletion is attempted; updates exceeding Telegram's single-rich-message limit are reported explicitly.
+
 ## 0.5.42 - 2026-06-18
 
 ### 中文

package/dist/controller/activity.js

@@ -166,7 +166,7 @@ export function classifyAgentOutput(phase, completed) {
         return completed ? 'final_answer' : 'commentary';
     }
     const normalized = phase.replace(/[^a-z]/gi, '').toLowerCase();
-    if (normalized === 'final' || normalized === 'answer' || normalized === 'response') {
+    if (normalized === 'final' || normalized === 'finalanswer' || normalized === 'answer' || normalized === 'response') {
         return 'final_answer';
     }
     return 'commentary';

package/dist/controller/controller.d.ts

@@ -236,6 +236,7 @@ export declare class BridgeSessionCore {
     private deleteMessage;
     private sendTyping;
     private sendObservedCliUserMessage;
+    private collapseTurnCommentary;
     private cleanupObservedTransientMessages;
     private hasObservedPersistentReply;
     private ensureThreadReady;

package/dist/controller/controller.js

@@ -1855,6 +1855,7 @@ export class BridgeSessionCore {
         const segment = ensureTurnSegment(active, `${active.turnId}:codex-error`, 'final_answer', 'final_answer', false);
         segment.text = text;
         segment.completed = true;
+        segment.completedAtMs = Date.now();
         await this.queueTurnRender(active, { forceStatus: true, forceStream: true });
     }
     async finishTerminalErroredActiveTurn(active) {
@@ -3131,6 +3132,7 @@ export class BridgeSessionCore {
         let shouldMarkPartialOutput = false;
         try {
             await this.queueTurnRender(active, { forceStatus: true, forceStream: true });
+            await this.collapseTurnCommentary(active);
             const renderedMessages = active.segments.reduce((count, segment) => count + segment.messages.length, 0);
             if (renderedMessages === 0) {
                 const fallbackKey = active.interruptRequested ? 'interrupted' : 'completed';
@@ -3186,6 +3188,7 @@ export class BridgeSessionCore {
                     }
                 }
                 segment.completed = true;
+                segment.completedAtMs = Date.now();
                 await this.queueTurnRender(active, { forceStream: true, forceStatus: true });
                 return;
             }
@@ -3421,6 +3424,50 @@ export class BridgeSessionCore {
             await this.sendHtmlMessage(scopeId, body);
         }
     }
+    async collapseTurnCommentary(active) {
+        if (active.scopeId.startsWith(BRIDGE_SCOPE_WEIXIN_PREFIX) || !this.hasObservedPersistentReply(active)) {
+            return;
+        }
+        const segments = active.segments.filter(segment => (segment.outputKind === 'commentary' && Boolean(segment.text.trim()) && segment.messages.length > 0));
+        const messages = segments.flatMap(segment => segment.messages);
+        const firstMessage = messages[0];
+        if (!firstMessage) {
+            return;
+        }
+        const locale = this.localeForChat(active.scopeId);
+        const html = renderCollapsedCommentary(locale, segments);
+        const fallback = locale === 'zh'
+            ? `过程汇报（${segments.length} 条，已折叠）`
+            : `Progress updates (${segments.length}, collapsed)`;
+        try {
+            await this.messaging.editRichHtml(active.scopeId, firstMessage.messageId, html, fallback, []);
+        }
+        catch (error) {
+            this.logger.warn('telegram.commentary_collapse_failed', {
+                error: String(error),
+                turnId: active.turnId,
+                messageId: firstMessage.messageId,
+            });
+            return;
+        }
+        for (const message of messages.slice(1)) {
+            try {
+                await this.deleteMessage(active.scopeId, message.messageId);
+            }
+            catch (error) {
+                if (!isTelegramMessageGone(error)) {
+                    this.logger.warn('telegram.commentary_collapse_delete_failed', {
+                        error: String(error),
+                        turnId: active.turnId,
+                        messageId: message.messageId,
+                    });
+                }
+            }
+        }
+        for (const segment of segments) {
+            segment.messages = [];
+        }
+    }
     async cleanupObservedTransientMessages(active) {
         if (!active.isObserved || !this.hasObservedPersistentReply(active)) {
             return;
@@ -8235,11 +8282,50 @@ function ensureTurnSegment(active, itemId, phase, outputKind, isPlan) {
         isPlan: Boolean(isPlan),
         text: '',
         completed: false,
+        startedAtMs: Date.now(),
+        completedAtMs: null,
         messages: [],
     };
     active.segments.push(segment);
     return segment;
 }
+function renderCollapsedCommentary(locale, segments) {
+    const firstAt = segments[0]?.startedAtMs ?? Date.now();
+    const lastSegment = segments[segments.length - 1];
+    const lastAt = lastSegment?.completedAtMs ?? lastSegment?.startedAtMs ?? firstAt;
+    const range = firstAt === lastAt
+        ? formatClockTimestamp(firstAt)
+        : `${formatClockTimestamp(firstAt)} - ${formatClockTimestamp(lastAt)}`;
+    const summary = locale === 'zh'
+        ? `过程汇报 · ${segments.length} 条 · ${range}`
+        : `Progress · ${segments.length} updates · ${range}`;
+    const maxBodyLength = TELEGRAM_RICH_MESSAGE_TEXT_LIMIT - summary.length - 1024;
+    const blocks = [];
+    let bodyLength = 0;
+    let omitted = 0;
+    for (const segment of segments) {
+        const endAt = segment.completedAtMs ?? segment.startedAtMs;
+        const timestamp = endAt === segment.startedAtMs
+            ? formatClockTimestamp(segment.startedAtMs)
+            : `${formatClockTimestamp(segment.startedAtMs)} - ${formatClockTimestamp(endAt)}`;
+        const block = `<h4>${escapeTelegramHtml(timestamp)}</h4>\n${renderTelegramMarkdownRichHtml(segment.text)}`;
+        if (bodyLength + block.length > maxBodyLength) {
+            omitted += 1;
+            continue;
+        }
+        blocks.push(block);
+        bodyLength += block.length;
+    }
+    if (omitted > 0) {
+        blocks.push(`<p>${escapeTelegramHtml(locale === 'zh' ? `另有 ${omitted} 条过长内容未收入归档` : `${omitted} oversized updates omitted`)}</p>`);
+    }
+    return telegramDetails(summary, blocks.join('\n'));
+}
+function formatClockTimestamp(timestampMs) {
+    const date = new Date(timestampMs);
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
 function createToolBatchState() {
     return {
         openCallIds: new Set(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.5.42",
+  "version": "0.5.44",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",