@foxden-app/foxclaw 0.5.53 → 0.5.54

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.54 - 2026-06-20
+
+### 中文
+- 修复升级到 Codex CLI `0.141.0` 后 Telegram 看不到工具执行明细的问题；FoxClaw 现在支持现代 app-server 的 `item/started` / `item/completed` 工具生命周期。
+- 命令执行、文件修改、网页搜索、MCP/动态工具、图片查看和生成、协作 Agent 操作会重新实时显示；阶段结束后仍压缩为可展开明细，最终过程汇报继续独立折叠。
+- 保留旧版 `codex/event/exec_command_begin/end` 兼容，避免旧节点或旧 Codex CLI 失去过程状态。
+
+### English
+- Fixed Telegram tool activity details disappearing after upgrading to Codex CLI `0.141.0`; FoxClaw now supports the modern app-server `item/started` and `item/completed` tool lifecycle.
+- Command execution, file changes, web search, MCP/dynamic tools, image activity, and collaborative agent operations are visible in real time again, then archived into expandable stage details.
+- Kept compatibility with legacy `codex/event/exec_command_begin/end` notifications for older Codex CLI installations.
+
 ## 0.5.53 - 2026-06-20
 
 ### 中文

package/dist/controller/activity.js

@@ -52,6 +52,10 @@ function normalizeStartedEvent(params) {
             state: 'thinking',
         };
     }
+    const toolEvent = normalizeThreadItemToolEvent(params, 'tool_started');
+    if (toolEvent) {
+        return toolEvent;
+    }
     if (!isRelayableTextItemType(itemType)) {
         return null;
     }
@@ -113,6 +117,10 @@ function normalizeCompletedEvent(params) {
             state: 'thinking',
         };
     }
+    const toolEvent = normalizeThreadItemToolEvent(params, 'tool_completed');
+    if (toolEvent) {
+        return toolEvent;
+    }
     if (!isRelayableTextItemType(itemType)) {
         return null;
     }
@@ -161,6 +169,86 @@ function normalizeToolEvent(params, kind) {
         state: inferToolActivityState(exec),
     };
 }
+function normalizeThreadItemToolEvent(params, kind) {
+    const turnId = extractTurnId(params);
+    const item = params?.item;
+    const itemId = extractItemId(item);
+    const itemType = normalizeEventItemType(item);
+    if (!turnId || !itemId || !itemType) {
+        return null;
+    }
+    let command = [];
+    let cwd = null;
+    let parsedCmd = [];
+    switch (itemType) {
+        case 'commandexecution':
+            command = typeof item.command === 'string' ? [item.command] : [];
+            cwd = typeof item.cwd === 'string' ? item.cwd : null;
+            parsedCmd = normalizeCommandActions(item.commandActions);
+            break;
+        case 'filechange':
+            parsedCmd = normalizeFileChanges(item.changes);
+            break;
+        case 'websearch':
+            parsedCmd = [{
+                    type: 'search',
+                    query: typeof item.query === 'string' ? item.query : '',
+                    path: null,
+                }];
+            break;
+        case 'imageview':
+            parsedCmd = [{ type: 'read', path: typeof item.path === 'string' ? item.path : null }];
+            break;
+        case 'mcptoolcall':
+            command = [`MCP ${String(item.server ?? 'server')}/${String(item.tool ?? 'tool')}`];
+            break;
+        case 'dynamictoolcall':
+            command = [`Tool ${item.namespace ? `${String(item.namespace)}/` : ''}${String(item.tool ?? 'tool')}`];
+            break;
+        case 'collabagenttoolcall':
+            command = [`Agent ${String(item.tool ?? 'operation')}`];
+            break;
+        case 'imagegeneration':
+            command = ['Image generation'];
+            break;
+        default:
+            return null;
+    }
+    const exec = {
+        callId: itemId,
+        turnId,
+        command,
+        cwd,
+        parsedCmd,
+    };
+    return {
+        kind,
+        turnId,
+        exec,
+        state: inferToolActivityState(exec),
+    };
+}
+function normalizeCommandActions(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((entry) => {
+        const type = typeof entry?.type === 'string' ? entry.type : '';
+        if (type === 'listFiles') {
+            return { ...entry, type: 'list_files' };
+        }
+        return entry;
+    });
+}
+function normalizeFileChanges(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((entry) => ({
+        type: 'apply_patch',
+        path: typeof entry?.path === 'string' ? entry.path : null,
+    }));
+}
 export function classifyAgentOutput(phase, completed) {
     if (!phase) {
         return completed ? 'final_answer' : 'commentary';

package/package.json

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