@foxden-app/foxclaw 0.5.56 → 0.5.58

package/.env.example

@@ -81,7 +81,7 @@ CODEX_CLI_BIN=/absolute/path/to/codex
 # VOICE_SUMMARY_BUTTON_ENABLED=true
 # VOICE_SUMMARY_TEXT_LIMIT=180
 # VOICE_TEXT_LIMIT=2800
-# VOICE_TTS_TIMEOUT_MS=60000
+# VOICE_TTS_TIMEOUT_MS=300000
 
 # Optional: standard HTTP(S) proxy for Telegram and ChatGPT/Codex backend requests.
 # Put these in the same env file that `foxclaw start` installs into systemd/launchd.

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 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.58 - 2026-06-21
+
+### 中文
+- 修复重启恢复中的操作明细清理：FoxClaw 现在会把已折叠工具明细的 Telegram message id 持久化到 active turn preview，重启后最终答复完成时仍能按配置删除这些明细消息。
+- 将 `VOICE_TTS_TIMEOUT_MS` 默认值和示例配置改为 300000ms，适配 SoulX 等较慢语音后端；本机配置也已同步为 5 分钟。
+
+### English
+- Fixed operation-detail cleanup after restart recovery. FoxClaw now persists archived tool-detail Telegram message ids with active turn previews, so final-answer cleanup can still delete them after a service restart.
+- Changed the default and example `VOICE_TTS_TIMEOUT_MS` to 300000ms for slower voice backends such as SoulX; the local deployment config has been updated to five minutes as well.
+
+## 0.5.57 - 2026-06-21
+
+### 中文
+- 修复 SoulX SSH 语音后端 URL 构造错误：远端脚本现在正确展开 `$BASE_URL`，不再把 `${BASE_URL}` 字面量传给 curl 导致 `URL rejected: Bad hostname`。
+- SoulX SSH 语音请求现在也会把 `VOICE_TTS_TIMEOUT_MS` 下发给远端 curl，远端 `/health` 和 `/v1/tts` 请求会自行按超时退出，避免 SSH 被中断后留下长时间运行的 curl。
+
+### English
+- Fixed SoulX SSH voice backend URL construction. The remote script now expands `$BASE_URL` correctly instead of passing a literal `${BASE_URL}` to curl and failing with `URL rejected: Bad hostname`.
+- SoulX SSH voice requests now pass `VOICE_TTS_TIMEOUT_MS` down to remote curl for both `/health` and `/v1/tts`, preventing long-running remote curl processes after a timed-out SSH call.
+
 ## 0.5.56 - 2026-06-21
 
 ### 中文

package/dist/config.js

@@ -110,7 +110,7 @@ export function loadConfig() {
         voiceSummaryButtonEnabled: boolEnv('VOICE_SUMMARY_BUTTON_ENABLED', true),
         voiceSummaryTextLimit: intEnv('VOICE_SUMMARY_TEXT_LIMIT', 180),
         voiceTextLimit: intEnv('VOICE_TEXT_LIMIT', 2800),
-        voiceTtsTimeoutMs: intEnv('VOICE_TTS_TIMEOUT_MS', 60_000),
+        voiceTtsTimeoutMs: intEnv('VOICE_TTS_TIMEOUT_MS', 300_000),
     };
     ensureAppDirs(config);
     return config;

package/dist/controller/controller.js

@@ -2909,8 +2909,9 @@ export class BridgeSessionCore {
         const messageId = await this.sendMessage(record.scopeId, text, keyboard);
         this.store.updatePendingAttachmentBatchMessage(record.batchId, messageId);
     }
-    async registerActiveTurn(scopeId, chatId, chatType, topicId, threadId, turnId, previewMessageId, authRetry = null, collaborationMode = DEFAULT_COLLABORATION_MODE, queuedInputId = null) {
+    async registerActiveTurn(scopeId, chatId, chatType, topicId, threadId, turnId, previewMessageId, authRetry = null, collaborationMode = DEFAULT_COLLABORATION_MODE, queuedInputId = null, archivedMessageIds = []) {
         const active = this.createActiveTurnState(scopeId, chatId, chatType, topicId, threadId, turnId, previewMessageId, false, collaborationMode, queuedInputId);
+        active.archivedMessageIds = [...archivedMessageIds];
         active.authRetry = authRetry;
         this.setActiveTurn(scopeId, turnId, active);
         const pendingError = this.pendingTurnErrors.get(turnId);
@@ -2925,6 +2926,7 @@ export class BridgeSessionCore {
                 threadId,
                 messageId: previewMessageId,
                 isObserved: active.isObserved,
+                archivedMessageIds: active.archivedMessageIds,
             });
         }
         this.updateStatus();
@@ -7758,6 +7760,7 @@ export class BridgeSessionCore {
     async attachRecoveredTurnPreview(preview, target, snapshot, liveTurn) {
         await this.stopWatchingScopeThread(preview.scopeId, preview.threadId);
         const active = this.createActiveTurnState(preview.scopeId, target.chatId, target.chatType, target.topicId, preview.threadId, liveTurn.turnId, preview.messageId, preview.isObserved);
+        active.archivedMessageIds = [...preview.archivedMessageIds];
         this.setActiveTurn(preview.scopeId, liveTurn.turnId, active);
         this.store.saveActiveTurnPreview({
             turnId: liveTurn.turnId,
@@ -7765,6 +7768,7 @@ export class BridgeSessionCore {
             threadId: preview.threadId,
             messageId: preview.messageId,
             isObserved: preview.isObserved,
+            archivedMessageIds: active.archivedMessageIds,
         });
         const watcher = {
             scopeId: preview.scopeId,
@@ -7833,7 +7837,7 @@ export class BridgeSessionCore {
                 topicId: target.topicId,
                 collaborationMode: turnState.collaborationMode,
                 failedAuthTargets: new Set(),
-            }, turnState.collaborationMode);
+            }, turnState.collaborationMode, null, preview.archivedMessageIds);
             this.logger.info('telegram.preview_auto_resumed_after_restart', {
                 scopeId: preview.scopeId,
                 threadId: preview.threadId,
@@ -8042,6 +8046,7 @@ export class BridgeSessionCore {
                     threadId: active.threadId,
                     messageId,
                     isObserved: active.isObserved,
+                    archivedMessageIds: active.archivedMessageIds,
                 });
             }
             catch (error) {

package/dist/store/database.d.ts

@@ -5,6 +5,7 @@ export interface ActiveTurnPreviewRecord {
     threadId: string;
     messageId: number;
     isObserved: boolean;
+    archivedMessageIds: number[];
     createdAt: number;
     updatedAt: number;
 }
@@ -82,6 +83,7 @@ export declare class BridgeStore {
     countPendingApprovals(): number;
     saveActiveTurnPreview(record: Pick<ActiveTurnPreviewRecord, 'turnId' | 'scopeId' | 'threadId' | 'messageId'> & {
         isObserved?: boolean;
+        archivedMessageIds?: number[];
     }): void;
     listActiveTurnPreviews(): ActiveTurnPreviewRecord[];
     removeActiveTurnPreview(turnId: string): void;

package/dist/store/database.js

@@ -71,6 +71,7 @@ export class BridgeStore {
         thread_id TEXT NOT NULL,
         message_id INTEGER NOT NULL,
         is_observed INTEGER NOT NULL DEFAULT 0,
+        archived_message_ids TEXT NOT NULL DEFAULT '[]',
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL
       );
@@ -219,6 +220,7 @@ export class BridgeStore {
         this.ensureColumn('pending_user_inputs', 'status', "TEXT NOT NULL DEFAULT 'pending'");
         this.ensureColumn('pending_user_inputs', 'submitted_at', 'INTEGER');
         this.ensureColumn('active_turn_previews', 'is_observed', 'INTEGER NOT NULL DEFAULT 0');
+        this.ensureColumn('active_turn_previews', 'archived_message_ids', "TEXT NOT NULL DEFAULT '[]'");
         this.ensureColumn('codex_auth_candidates', 'state', "TEXT NOT NULL DEFAULT 'active'");
         this.ensureColumn('codex_auth_candidate_runtime', 'state', "TEXT NOT NULL DEFAULT 'active'");
         this.ensureColumn('codex_auth_quota_snapshots', 'plan_type', 'TEXT');
@@ -426,13 +428,13 @@ export class BridgeStore {
         const now = Date.now();
         this.db.prepare('DELETE FROM active_turn_previews WHERE turn_id = ? OR scope_id = ?').run(record.turnId, record.scopeId);
         this.db.prepare(`
-      INSERT INTO active_turn_previews (turn_id, scope_id, thread_id, message_id, is_observed, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?)
-    `).run(record.turnId, record.scopeId, record.threadId, record.messageId, record.isObserved ? 1 : 0, now, now);
+      INSERT INTO active_turn_previews (turn_id, scope_id, thread_id, message_id, is_observed, archived_message_ids, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(record.turnId, record.scopeId, record.threadId, record.messageId, record.isObserved ? 1 : 0, JSON.stringify(normalizeMessageIds(record.archivedMessageIds ?? [])), now, now);
     }
     listActiveTurnPreviews() {
         const rows = this.db.prepare(`
-      SELECT turn_id, scope_id, thread_id, message_id, is_observed, created_at, updated_at
+      SELECT turn_id, scope_id, thread_id, message_id, is_observed, archived_message_ids, created_at, updated_at
       FROM active_turn_previews
       ORDER BY created_at ASC
     `).all();
@@ -442,6 +444,7 @@ export class BridgeStore {
             threadId: String(row.thread_id),
             messageId: Number(row.message_id),
             isObserved: Boolean(row.is_observed),
+            archivedMessageIds: parseMessageIdArray(row.archived_message_ids),
             createdAt: Number(row.created_at),
             updatedAt: Number(row.updated_at),
         }));
@@ -1065,6 +1068,23 @@ function nullableNumber(value) {
 function nullableString(value) {
     return typeof value === 'string' && value.trim() ? value : null;
 }
+function normalizeMessageIds(values) {
+    return [...new Set(values.filter((value) => Number.isSafeInteger(value) && value > 0))];
+}
+function parseMessageIdArray(value) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed)
+            ? normalizeMessageIds(parsed.map((entry) => Number(entry)))
+            : [];
+    }
+    catch {
+        return [];
+    }
+}
 function normalizeCodexAuthCandidateState(value) {
     return value === 'needs_repair' ? 'needs_repair' : 'active';
 }

package/dist/voice/tts.js

@@ -42,7 +42,7 @@ async function synthesizeViaHttp(text, config) {
         throw new Error('VOICE_TTS_URL is not configured');
     }
     if (config.voiceTtsEngine === 'soulx') {
-        return convertToOggOpus(await requestTtsWav(config, '/v1/tts', { text, seed: '7' }), config.voiceFfmpegBin);
+        return convertToOggOpus(await requestTtsWav(config, '/v1/tts', { text, seed: 7 }), config.voiceFfmpegBin);
     }
     try {
         return convertToOggOpus(await requestTtsWav(config, '/v1/tts/custom', { text, language: 'zh' }), config.voiceFfmpegBin);
@@ -194,23 +194,25 @@ async function synthesizeSoulxViaSsh(text, config) {
     }
     const encodedText = Buffer.from(text, 'utf8').toString('base64');
     const baseUrl = config.voiceTtsUrl || 'http://127.0.0.1:18082';
+    const curlMaxTimeSeconds = Math.max(1, Math.ceil(config.voiceTtsTimeoutMs / 1000));
     const script = String.raw `set -euo pipefail
 TEXT="$(printf '%s' "$1" | base64 -d)"
 ENV_DIR="$2"
 BASE_URL="$3"
+CURL_MAX_TIME="$4"
 cd "$ENV_DIR"
 set -a
 . ./.env
 set +a
 tmp="$(mktemp -d)"
 trap 'rm -rf "$tmp"' EXIT
-curl -sS "\${BASE_URL}/health" >/dev/null
+curl -sS --connect-timeout 5 --max-time "$CURL_MAX_TIME" "$BASE_URL/health" >/dev/null
 TEXT="$TEXT" python3 - <<'PY' > "$tmp/body.json"
 import json
 import os
 print(json.dumps({"text": os.environ["TEXT"], "seed": 7, "dialect_prompt": ""}, ensure_ascii=False))
 PY
-status="$(curl -sS -w '%{http_code}' -X POST "\${BASE_URL}/v1/tts" \
+status="$(curl -sS --connect-timeout 5 --max-time "$CURL_MAX_TIME" -w '%{http_code}' -X POST "$BASE_URL/v1/tts" \
   -H "Authorization: Bearer $QWEN_SPEECH_API_TOKEN" \
   -H "Content-Type: application/json" \
   --data-binary "@$tmp/body.json" \
@@ -238,6 +240,7 @@ PY
         encodedText,
         envDir,
         baseUrl,
+        String(curlMaxTimeSeconds),
     ], script, config.voiceTtsTimeoutMs);
 }
 async function runSshBinary(args, stdin, timeoutMs) {

package/package.json

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