@foxden-app/foxclaw 0.5.60 → 0.5.61

package/.env.example

@@ -38,9 +38,9 @@ TELEGRAM_PREVIEW_THROTTLE_MS=800
 # Set to false if you prefer to keep "read files / edited files / ran command"
 # detail cards in the chat history.
 # TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL=true
-# Delete time-sensitive interactive panels such as /auth and /threads after 30 minutes.
+# Delete time-sensitive interactive panels such as /auth, /setup, and /threads after 5 minutes.
 # The timer restarts whenever the panel is refreshed. Set to 0 to disable.
-# TELEGRAM_PANEL_TTL_MS=1800000
+# TELEGRAM_PANEL_TTL_MS=300000
 THREAD_LIST_LIMIT=10
 CODEX_CLI_BIN=/absolute/path/to/codex
 

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.61 - 2026-06-21
+
+### 中文
+- 将 `/auth`、`/setup`、`/threads` 等交互面板的默认自动清理时间从 30 分钟改为 5 分钟，并把 `/where`、旧 model/access 设置面板和 `/config` 面板纳入同一类时效清理。
+- `/config` 现在明确定位为 FoxClaw 自身设置面板，新增“最终回复后删除操作明细”开关；可通过按钮或 `/config delete_tool_details <on|off>` 修改，并写回 `TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL`。
+- `/config` 展示当前 `TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL` 和 `TELEGRAM_PANEL_TTL_MS`，方便确认聊天清理策略是否生效。
+
+### English
+- Changed the default cleanup timeout for interactive panels such as `/auth`, `/setup`, and `/threads` from 30 minutes to 5 minutes, and applied the same stale-panel cleanup to `/where`, legacy model/access settings panels, and `/config`.
+- `/config` is now the FoxClaw runtime settings panel and includes a "delete operation details after final reply" toggle. It can be changed via the button or `/config delete_tool_details <on|off>`, writing `TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL`.
+- `/config` shows the current `TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL` and `TELEGRAM_PANEL_TTL_MS` values so cleanup behavior is visible.
+
 ## 0.5.60 - 2026-06-21
 
 ### 中文

package/dist/config.js

@@ -78,7 +78,7 @@ export function loadConfig() {
         telegramPollIntervalMs: intEnv('TELEGRAM_POLL_INTERVAL_MS', 1200),
         telegramPreviewThrottleMs: intEnv('TELEGRAM_PREVIEW_THROTTLE_MS', 800),
         telegramDeleteToolDetailsAfterFinal: boolEnv('TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL', true),
-        telegramPanelTtlMs: intEnv('TELEGRAM_PANEL_TTL_MS', 30 * 60_000),
+        telegramPanelTtlMs: intEnv('TELEGRAM_PANEL_TTL_MS', 5 * 60_000),
         threadListLimit: intEnv('THREAD_LIST_LIMIT', 10),
         statusPath: DEFAULT_STATUS_PATH,
         logPath: DEFAULT_LOG_PATH,

package/dist/controller/controller.d.ts

@@ -352,7 +352,7 @@ export declare class BridgeSessionCore {
     private handleFeaturesCommand;
     private handleConfigCommand;
     private handleConfigToggleCallback;
-    private setAuthAutoDeleteNeedsRepair;
+    private setFoxClawBooleanConfig;
     private formatConfigToggleUpdate;
     private handleRequirementsCommand;
     private handleProviderCommand;

package/dist/controller/controller.js

@@ -1088,9 +1088,9 @@ export class BridgeSessionCore {
             await this.handleSetupCallback(event, setupMatch[1], setupMatch[2], locale);
             return;
         }
-        const configMatch = /^config:auth_auto_delete:(on|off)$/.exec(event.data);
+        const configMatch = /^config:(auth_auto_delete|delete_tool_details):(on|off)$/.exec(event.data);
         if (configMatch) {
-            await this.handleConfigToggleCallback(event, configMatch[1] === 'on', locale);
+            await this.handleConfigToggleCallback(event, configMatch[1], configMatch[2] === 'on', locale);
             return;
         }
         const voiceMatch = /^voice:([a-f0-9]+)$/.exec(event.data);
@@ -5583,46 +5583,73 @@ export class BridgeSessionCore {
                 await this.sendMessage(scopeId, t(locale, 'config_auth_auto_delete_usage'));
                 return;
             }
-            const update = await this.setAuthAutoDeleteNeedsRepair(enabled);
+            const update = await this.setFoxClawBooleanConfig('auth_auto_delete', enabled);
             const binding = this.store.getBinding(scopeId);
             const result = await this.app.readConfig(binding?.cwd ?? this.config.defaultCwd, true);
-            await this.sendMessage(scopeId, `${this.formatConfigToggleUpdate(locale, update)}\n\n${formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats())}`, configKeyboard(locale, this.config));
+            const sentMessageId = await this.sendMessage(scopeId, `${this.formatConfigToggleUpdate(locale, update)}\n\n${formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats())}`, configKeyboard(locale, this.config));
+            this.scheduleStalePanelDeletion(scopeId, sentMessageId);
+            return;
+        }
+        if (['delete_tool_details', 'delete-tool-details', 'tool_details', 'tool-details'].includes(action)) {
+            const enabled = parseConfigBooleanArg(args[1]);
+            if (enabled === null) {
+                await this.sendMessage(scopeId, t(locale, 'config_delete_tool_details_usage'));
+                return;
+            }
+            const update = await this.setFoxClawBooleanConfig('delete_tool_details', enabled);
+            const binding = this.store.getBinding(scopeId);
+            const result = await this.app.readConfig(binding?.cwd ?? this.config.defaultCwd, true);
+            const sentMessageId = await this.sendMessage(scopeId, `${this.formatConfigToggleUpdate(locale, update)}\n\n${formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats())}`, configKeyboard(locale, this.config));
+            this.scheduleStalePanelDeletion(scopeId, sentMessageId);
             return;
         }
         const binding = this.store.getBinding(scopeId);
         const result = await this.app.readConfig(binding?.cwd ?? this.config.defaultCwd, true);
-        await this.sendMessage(scopeId, formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats()), configKeyboard(locale, this.config));
+        const sentMessageId = await this.sendMessage(scopeId, formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats()), configKeyboard(locale, this.config));
+        this.scheduleStalePanelDeletion(scopeId, sentMessageId);
     }
-    async handleConfigToggleCallback(event, enabled, locale) {
-        const update = await this.setAuthAutoDeleteNeedsRepair(enabled);
+    async handleConfigToggleCallback(event, key, enabled, locale) {
+        const update = await this.setFoxClawBooleanConfig(key, enabled);
         await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'decision_recorded'));
         const binding = this.store.getBinding(event.scopeId);
         const result = await this.app.readConfig(binding?.cwd ?? this.config.defaultCwd, true);
         const message = `${this.formatConfigToggleUpdate(locale, update)}\n\n${formatConfigMessage(locale, result, this.config, this.store.getCodexAuthPoolStats())}`;
         if (event.messageId !== null) {
             await this.editMessage(event.scopeId, event.messageId, message, configKeyboard(locale, this.config));
+            this.scheduleStalePanelDeletion(event.scopeId, event.messageId);
         }
         else {
-            await this.sendMessage(event.scopeId, message, configKeyboard(locale, this.config));
+            const sentMessageId = await this.sendMessage(event.scopeId, message, configKeyboard(locale, this.config));
+            this.scheduleStalePanelDeletion(event.scopeId, sentMessageId);
         }
     }
-    async setAuthAutoDeleteNeedsRepair(enabled) {
-        this.config.authAutoDeleteNeedsRepair = enabled;
+    async setFoxClawBooleanConfig(key, enabled) {
+        const envKey = key === 'auth_auto_delete'
+            ? 'AUTH_AUTO_DELETE_NEEDS_REPAIR'
+            : 'TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL';
+        if (key === 'auth_auto_delete') {
+            this.config.authAutoDeleteNeedsRepair = enabled;
+        }
+        else {
+            this.config.telegramDeleteToolDetailsAfterFinal = enabled;
+        }
         const envPath = this.config.envPath;
         if (!envPath) {
-            return { enabled, envPath: null, envUpdated: false, envError: null };
+            return { key, enabled, envKey, envPath: null, envUpdated: false, envError: null };
         }
         try {
-            await writeEnvBoolean(envPath, 'AUTH_AUTO_DELETE_NEEDS_REPAIR', enabled);
-            return { enabled, envPath, envUpdated: true, envError: null };
+            await writeEnvBoolean(envPath, envKey, enabled);
+            return { key, enabled, envKey, envPath, envUpdated: true, envError: null };
         }
         catch (error) {
-            this.logger.warn('config.env_update_failed', { key: 'AUTH_AUTO_DELETE_NEEDS_REPAIR', envPath, error: toErrorMeta(error) });
-            return { enabled, envPath, envUpdated: false, envError: formatUserError(error) };
+            this.logger.warn('config.env_update_failed', { key: envKey, envPath, error: toErrorMeta(error) });
+            return { key, enabled, envKey, envPath, envUpdated: false, envError: formatUserError(error) };
         }
     }
     formatConfigToggleUpdate(locale, update) {
-        const lines = [t(locale, 'config_auth_auto_delete_updated', { value: t(locale, update.enabled ? 'yes' : 'no') })];
+        const lines = [t(locale, update.key === 'auth_auto_delete' ? 'config_auth_auto_delete_updated' : 'config_delete_tool_details_updated', {
+                value: t(locale, update.enabled ? 'yes' : 'no'),
+            })];
         if (update.envError) {
             lines.push(t(locale, 'config_env_update_failed', { value: update.envPath ?? t(locale, 'unknown'), error: update.envError }));
         }
@@ -7207,9 +7234,11 @@ export class BridgeSessionCore {
             }
             if (messageId !== undefined) {
                 await this.editMessage(scopeId, messageId, text, whereKeyboard(locale, false));
+                this.scheduleStalePanelDeletion(scopeId, messageId);
                 return;
             }
-            await this.sendMessage(scopeId, text, whereKeyboard(locale, false));
+            const sentMessageId = await this.sendMessage(scopeId, text, whereKeyboard(locale, false));
+            this.scheduleStalePanelDeletion(scopeId, sentMessageId);
             return;
         }
         const readyBinding = await this.ensureThreadReady(scopeId, binding);
@@ -7221,9 +7250,11 @@ export class BridgeSessionCore {
             }
             if (messageId !== undefined) {
                 await this.editMessage(scopeId, messageId, text, whereKeyboard(locale, false));
+                this.scheduleStalePanelDeletion(scopeId, messageId);
                 return;
             }
-            await this.sendMessage(scopeId, text, whereKeyboard(locale, false));
+            const sentMessageId = await this.sendMessage(scopeId, text, whereKeyboard(locale, false));
+            this.scheduleStalePanelDeletion(scopeId, sentMessageId);
             return;
         }
         let text = formatWhereMessage(locale, thread, settings, this.config.defaultCwd, access, fastStatus);
@@ -7232,9 +7263,11 @@ export class BridgeSessionCore {
         }
         if (messageId !== undefined) {
             await this.editMessage(scopeId, messageId, text, whereKeyboard(locale, true));
+            this.scheduleStalePanelDeletion(scopeId, messageId);
             return;
         }
-        await this.sendMessage(scopeId, text, whereKeyboard(locale, true));
+        const sentMessageId = await this.sendMessage(scopeId, text, whereKeyboard(locale, true));
+        this.scheduleStalePanelDeletion(scopeId, sentMessageId);
     }
     async handleThreadListNavigationCallback(event, action, locale) {
         const state = this.threadListPresentationState.get(event.scopeId) ?? {
@@ -7342,9 +7375,11 @@ export class BridgeSessionCore {
         const keyboard = buildModelSettingsKeyboard(locale, models, settings);
         if (messageId !== undefined) {
             await this.editHtmlMessage(scopeId, messageId, text, keyboard);
+            this.scheduleStalePanelDeletion(scopeId, messageId);
             return;
         }
-        await this.sendHtmlMessage(scopeId, text, keyboard);
+        const sentMessageId = await this.sendHtmlMessage(scopeId, text, keyboard);
+        this.scheduleStalePanelDeletion(scopeId, sentMessageId);
     }
     async showSetupPanel(scopeId, focus, messageId, locale = this.localeForChat(scopeId)) {
         const models = await this.app.listModels();
@@ -7375,9 +7410,11 @@ export class BridgeSessionCore {
         const keyboard = buildAccessSettingsKeyboard(locale, access);
         if (messageId !== undefined) {
             await this.editHtmlMessage(scopeId, messageId, text, keyboard);
+            this.scheduleStalePanelDeletion(scopeId, messageId);
             return;
         }
-        await this.sendHtmlMessage(scopeId, text, keyboard);
+        const sentMessageId = await this.sendHtmlMessage(scopeId, text, keyboard);
+        this.scheduleStalePanelDeletion(scopeId, sentMessageId);
     }
     async handleSettingsCallback(event, kind, rawValue, locale) {
         await this.handleSetupCallback(event, kind, rawValue, locale);
@@ -9359,6 +9396,12 @@ function formatConfigMessage(locale, result, appConfig, authPoolStats) {
         value: t(locale, appConfig.authAutoDeleteNeedsRepair ? 'yes' : 'no'),
     }));
     lines.push(`AUTH_AUTO_DELETE_NEEDS_REPAIR=${appConfig.authAutoDeleteNeedsRepair ? 'true' : 'false'}`);
+    lines.push(t(locale, 'config_delete_tool_details_after_final', {
+        value: t(locale, appConfig.telegramDeleteToolDetailsAfterFinal ? 'yes' : 'no'),
+    }));
+    lines.push(`TELEGRAM_DELETE_TOOL_DETAILS_AFTER_FINAL=${appConfig.telegramDeleteToolDetailsAfterFinal ? 'true' : 'false'}`);
+    lines.push(t(locale, 'config_panel_ttl', { value: formatDurationMs(locale, appConfig.telegramPanelTtlMs) }));
+    lines.push(`TELEGRAM_PANEL_TTL_MS=${appConfig.telegramPanelTtlMs}`);
     lines.push(formatCodexAuthPoolSummary(locale, authPoolStats));
     return lines.join('\n');
 }
@@ -9373,11 +9416,32 @@ function isInvalidCodexAuthDeleteReason(reason) {
     return reason === AUTH_DELETE_REASON_NEEDS_REPAIR;
 }
 function configKeyboard(locale, appConfig) {
-    const enabled = appConfig.authAutoDeleteNeedsRepair;
-    return [[{
-                text: t(locale, enabled ? 'button_config_auth_auto_delete_off' : 'button_config_auth_auto_delete_on'),
-                callback_data: `config:auth_auto_delete:${enabled ? 'off' : 'on'}`,
-            }]];
+    const authAutoDeleteEnabled = appConfig.authAutoDeleteNeedsRepair;
+    const deleteToolDetailsEnabled = appConfig.telegramDeleteToolDetailsAfterFinal;
+    return [
+        [{
+                text: t(locale, authAutoDeleteEnabled ? 'button_config_auth_auto_delete_off' : 'button_config_auth_auto_delete_on'),
+                callback_data: `config:auth_auto_delete:${authAutoDeleteEnabled ? 'off' : 'on'}`,
+            }],
+        [{
+                text: t(locale, deleteToolDetailsEnabled ? 'button_config_delete_tool_details_off' : 'button_config_delete_tool_details_on'),
+                callback_data: `config:delete_tool_details:${deleteToolDetailsEnabled ? 'off' : 'on'}`,
+            }],
+    ];
+}
+function formatDurationMs(locale, value) {
+    if (value <= 0) {
+        return locale === 'zh' ? '关闭' : 'disabled';
+    }
+    if (value % 60_000 === 0) {
+        const minutes = value / 60_000;
+        return locale === 'zh' ? `${minutes} 分钟` : `${minutes} min`;
+    }
+    if (value % 1000 === 0) {
+        const seconds = value / 1000;
+        return locale === 'zh' ? `${seconds} 秒` : `${seconds} sec`;
+    }
+    return `${value}ms`;
 }
 function parseConfigBooleanArg(value) {
     const normalized = value?.trim().toLowerCase();

package/dist/i18n.d.ts

@@ -282,6 +282,8 @@ declare const MESSAGES: {
         readonly button_auth_filter_attention: "Attention";
         readonly button_config_auth_auto_delete_on: "Auto-delete on";
         readonly button_config_auth_auto_delete_off: "Auto-delete off";
+        readonly button_config_delete_tool_details_on: "Delete tool details";
+        readonly button_config_delete_tool_details_off: "Keep tool details";
         readonly another_turn_running: "Another turn is already running. Use /interrupt, /takeover, /queue, or wait.";
         readonly working: "Working...";
         readonly usage_open: "Usage: /open <n>";
@@ -617,6 +619,10 @@ declare const MESSAGES: {
         readonly config_auth_auto_delete_needs_repair: "Auto-delete unrecoverable auth candidates: {value}";
         readonly config_auth_auto_delete_updated: "Auto-delete unrecoverable auth candidates set to: {value}";
         readonly config_auth_auto_delete_usage: "Usage: /config auth_auto_delete <on|off>";
+        readonly config_delete_tool_details_after_final: "Delete operation details after final reply: {value}";
+        readonly config_delete_tool_details_updated: "Delete operation details after final reply set to: {value}";
+        readonly config_delete_tool_details_usage: "Usage: /config delete_tool_details <on|off>";
+        readonly config_panel_ttl: "Interactive panel cleanup: {value}";
         readonly config_env_update_failed: "Runtime setting changed, but updating {value} failed: {error}";
         readonly requirements_title: "Config requirements";
         readonly requirements_empty: "No config requirements are configured.";
@@ -982,6 +988,8 @@ declare const MESSAGES: {
         readonly button_auth_filter_attention: "需关注";
         readonly button_config_auth_auto_delete_on: "开启自动剔除";
         readonly button_config_auth_auto_delete_off: "关闭自动剔除";
+        readonly button_config_delete_tool_details_on: "删除操作明细";
+        readonly button_config_delete_tool_details_off: "保留操作明细";
         readonly another_turn_running: "已经有一个回复在进行中。请先等待，或使用 /interrupt、/takeover、/queue。";
         readonly working: "处理中...";
         readonly usage_open: "用法：/open <编号>";
@@ -1317,6 +1325,10 @@ declare const MESSAGES: {
         readonly config_auth_auto_delete_needs_repair: "自动剔除无法恢复的 auth 候选：{value}";
         readonly config_auth_auto_delete_updated: "自动剔除无法恢复的 auth 候选已设置为：{value}";
         readonly config_auth_auto_delete_usage: "用法：/config auth_auto_delete <on|off>";
+        readonly config_delete_tool_details_after_final: "最终回复后删除操作明细：{value}";
+        readonly config_delete_tool_details_updated: "最终回复后删除操作明细已设置为：{value}";
+        readonly config_delete_tool_details_usage: "用法：/config delete_tool_details <on|off>";
+        readonly config_panel_ttl: "交互面板自动清理：{value}";
         readonly config_env_update_failed: "运行时设置已改变，但更新 {value} 失败：{error}";
         readonly requirements_title: "配置要求";
         readonly requirements_empty: "当前没有配置要求。";

package/dist/i18n.js

@@ -280,6 +280,8 @@ const MESSAGES = {
         button_auth_filter_attention: 'Attention',
         button_config_auth_auto_delete_on: 'Auto-delete on',
         button_config_auth_auto_delete_off: 'Auto-delete off',
+        button_config_delete_tool_details_on: 'Delete tool details',
+        button_config_delete_tool_details_off: 'Keep tool details',
         another_turn_running: 'Another turn is already running. Use /interrupt, /takeover, /queue, or wait.',
         working: 'Working...',
         usage_open: 'Usage: /open <n>',
@@ -615,6 +617,10 @@ const MESSAGES = {
         config_auth_auto_delete_needs_repair: 'Auto-delete unrecoverable auth candidates: {value}',
         config_auth_auto_delete_updated: 'Auto-delete unrecoverable auth candidates set to: {value}',
         config_auth_auto_delete_usage: 'Usage: /config auth_auto_delete <on|off>',
+        config_delete_tool_details_after_final: 'Delete operation details after final reply: {value}',
+        config_delete_tool_details_updated: 'Delete operation details after final reply set to: {value}',
+        config_delete_tool_details_usage: 'Usage: /config delete_tool_details <on|off>',
+        config_panel_ttl: 'Interactive panel cleanup: {value}',
         config_env_update_failed: 'Runtime setting changed, but updating {value} failed: {error}',
         requirements_title: 'Config requirements',
         requirements_empty: 'No config requirements are configured.',
@@ -980,6 +986,8 @@ const MESSAGES = {
         button_auth_filter_attention: '需关注',
         button_config_auth_auto_delete_on: '开启自动剔除',
         button_config_auth_auto_delete_off: '关闭自动剔除',
+        button_config_delete_tool_details_on: '删除操作明细',
+        button_config_delete_tool_details_off: '保留操作明细',
         another_turn_running: '已经有一个回复在进行中。请先等待，或使用 /interrupt、/takeover、/queue。',
         working: '处理中...',
         usage_open: '用法：/open <编号>',
@@ -1315,6 +1323,10 @@ const MESSAGES = {
         config_auth_auto_delete_needs_repair: '自动剔除无法恢复的 auth 候选：{value}',
         config_auth_auto_delete_updated: '自动剔除无法恢复的 auth 候选已设置为：{value}',
         config_auth_auto_delete_usage: '用法：/config auth_auto_delete <on|off>',
+        config_delete_tool_details_after_final: '最终回复后删除操作明细：{value}',
+        config_delete_tool_details_updated: '最终回复后删除操作明细已设置为：{value}',
+        config_delete_tool_details_usage: '用法：/config delete_tool_details <on|off>',
+        config_panel_ttl: '交互面板自动清理：{value}',
         config_env_update_failed: '运行时设置已改变，但更新 {value} 失败：{error}',
         requirements_title: '配置要求',
         requirements_empty: '当前没有配置要求。',

package/package.json

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