@foxden-app/foxclaw 0.5.26 → 0.5.28

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.28 - 2026-06-09
+
+### 中文
+- 重启续接恢复失败时不再立刻把 Telegram 状态卡改成“桥接重启、请手动继续”；FoxClaw 会保留 active preview 并在后台短间隔重试几分钟。
+- 这修复了 Codex app-server 刚重启时线程短暂 `thread not found`，导致自动续跑错过窗口、没有最终总结消息的问题。
+
+### English
+- Restart recovery no longer immediately retires the Telegram status card as "bridge restarted, continue manually" when the first recovery attempt fails. FoxClaw keeps the active preview and retries in the background for several minutes.
+- This fixes cases where the Codex app-server briefly reports `thread not found` right after restart, causing auto-resume to miss its window and never send the final summary.
+
+## 0.5.27 - 2026-06-09
+
+### 中文
+- 重启续接的完成判定进一步收窄：只有 final/final_answer 类 assistant 输出、plan 输出或明确错误才算已有完成结果。
+- 如果旧 turn 只有 commentary 进度消息，例如“正在升级本机服务”，重启后仍会自动续跑，避免状态卡显示“已完成”但没有真正收尾回复。
+
+### English
+- Tightened restart recovery completion detection: only final/final_answer assistant output, plan output, or an explicit error now counts as a completed result.
+- If the previous turn only had commentary progress such as "upgrading the local service", FoxClaw still auto-resumes it after restart instead of retiring the status card as completed without a real final reply.
+
 ## 0.5.26 - 2026-06-09
 
 ### 中文

package/dist/controller/controller.d.ts

@@ -88,6 +88,7 @@ export declare class BridgeSessionCore {
     private locks;
     private approvalTimers;
     private submittedUserInputTimers;
+    private restartPreviewRecoveryTimers;
     private selfUpdatePollTimer;
     private proactiveAuthRefreshTimer;
     private proactiveAuthRefreshInProgress;
@@ -418,6 +419,10 @@ export declare class BridgeSessionCore {
     private syncTurnStatus;
     private syncTurnStream;
     private cleanupStaleTurnPreviews;
+    private scheduleRestartPreviewRecovery;
+    private retryRestartPreviewRecovery;
+    private retireStaleRestartPreview;
+    private clearRestartPreviewRecoveryTimers;
     private recoverLiveTurnPreview;
     private attachRecoveredTurnPreview;
     private resumeInterruptedTurnAfterRestart;

package/dist/controller/controller.js

@@ -20,6 +20,7 @@ import { applySessionLog, bootstrapSessionLog, splitJsonlChunk, } from './sessio
 import { renderActiveTurnStatus } from './status.js';
 import { writeRuntimeStatus } from '../runtime.js';
 const AUTH_DELETE_REASON_NEEDS_REPAIR = 'needs_repair';
+const RESTART_PREVIEW_RECOVERY_RETRY_DELAYS_MS = [3000, 7000, 15_000, 30_000, 45_000, 60_000, 60_000, 60_000];
 class UserFacingError extends Error {
 }
 const OBSERVED_THREAD_POLL_MS = 1500;
@@ -136,6 +137,7 @@ export class BridgeSessionCore {
     locks = new Map();
     approvalTimers = new Map();
     submittedUserInputTimers = new Map();
+    restartPreviewRecoveryTimers = new Map();
     selfUpdatePollTimer = null;
     proactiveAuthRefreshTimer = null;
     proactiveAuthRefreshInProgress = false;
@@ -261,6 +263,7 @@ export class BridgeSessionCore {
             clearTimeout(timer);
         }
         this.submittedUserInputTimers.clear();
+        this.clearRestartPreviewRecoveryTimers();
         this.clearSelfUpdateStatusPoll();
         this.clearProactiveAuthRefreshTimer();
         await this.app.stop({ terminateServer: false });
@@ -7210,9 +7213,105 @@ export class BridgeSessionCore {
                     error: toErrorMeta(error),
                 });
             }
-            await this.retirePreviewMessage(preview.scopeId, preview.messageId, t(this.localeForChat(preview.scopeId), 'stale_preview_restarted', { threadId: preview.threadId }), preview.turnId);
+            this.scheduleRestartPreviewRecovery(preview, 0);
         }
     }
+    scheduleRestartPreviewRecovery(preview, attempt) {
+        const key = restartPreviewRecoveryKey(preview);
+        if (this.restartPreviewRecoveryTimers.has(key)) {
+            return;
+        }
+        const delayMs = RESTART_PREVIEW_RECOVERY_RETRY_DELAYS_MS[attempt];
+        if (delayMs === undefined) {
+            void this.retireStaleRestartPreview(preview).catch((error) => {
+                this.logger.warn('telegram.preview_stale_retire_failed', {
+                    scopeId: preview.scopeId,
+                    threadId: preview.threadId,
+                    turnId: preview.turnId,
+                    error: toErrorMeta(error),
+                });
+            });
+            return;
+        }
+        const timer = setTimeout(() => {
+            this.restartPreviewRecoveryTimers.delete(key);
+            void this.retryRestartPreviewRecovery(preview, attempt + 1).catch((error) => {
+                this.logger.warn('telegram.preview_recovery_retry_failed', {
+                    scopeId: preview.scopeId,
+                    threadId: preview.threadId,
+                    turnId: preview.turnId,
+                    attempt: attempt + 1,
+                    error: toErrorMeta(error),
+                });
+                this.scheduleRestartPreviewRecovery(preview, attempt + 1);
+            });
+        }, delayMs);
+        timer.unref?.();
+        this.restartPreviewRecoveryTimers.set(key, timer);
+        this.logger.info('telegram.preview_recovery_deferred', {
+            scopeId: preview.scopeId,
+            threadId: preview.threadId,
+            turnId: preview.turnId,
+            attempt: attempt + 1,
+            delayMs,
+        });
+    }
+    async retryRestartPreviewRecovery(preview, attempt) {
+        const current = this.store.listActiveTurnPreviews().find((record) => (record.scopeId === preview.scopeId
+            && record.turnId === preview.turnId
+            && record.messageId === preview.messageId));
+        if (!current) {
+            return;
+        }
+        if (!this.ownsScope(current.scopeId)) {
+            return;
+        }
+        if (!this.messaging.canSendToScope(current.scopeId)) {
+            this.store.removeActiveTurnPreview(current.turnId);
+            this.logger.info('telegram.preview_dropped_disabled_channel', {
+                scopeId: current.scopeId,
+                threadId: current.threadId,
+                turnId: current.turnId,
+            });
+            return;
+        }
+        try {
+            if (await this.recoverLiveTurnPreview(current)) {
+                this.logger.info('telegram.preview_recovery_retry_succeeded', {
+                    scopeId: current.scopeId,
+                    threadId: current.threadId,
+                    turnId: current.turnId,
+                    attempt,
+                });
+                return;
+            }
+        }
+        catch (error) {
+            this.logger.warn('telegram.preview_recovery_retry_failed', {
+                scopeId: current.scopeId,
+                threadId: current.threadId,
+                turnId: current.turnId,
+                attempt,
+                error: toErrorMeta(error),
+            });
+        }
+        this.scheduleRestartPreviewRecovery(current, attempt);
+    }
+    async retireStaleRestartPreview(preview) {
+        const current = this.store.listActiveTurnPreviews().find((record) => (record.scopeId === preview.scopeId
+            && record.turnId === preview.turnId
+            && record.messageId === preview.messageId));
+        if (!current) {
+            return;
+        }
+        await this.retirePreviewMessage(current.scopeId, current.messageId, t(this.localeForChat(current.scopeId), 'stale_preview_restarted', { threadId: current.threadId }), current.turnId);
+    }
+    clearRestartPreviewRecoveryTimers() {
+        for (const timer of this.restartPreviewRecoveryTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.restartPreviewRecoveryTimers.clear();
+    }
     async recoverLiveTurnPreview(preview) {
         if (this.getActiveTurn(preview.scopeId, preview.turnId)) {
             return true;
@@ -8472,8 +8571,17 @@ function turnHasRelayableOutcome(turn) {
     }
     return turn.items.some((item) => {
         const type = item.type.toLowerCase();
-        return ((type === 'agentmessage' || type === 'assistantmessage' || type === 'plan')
-            && Boolean(item.text?.trim()));
+        if (!item.text?.trim()) {
+            return false;
+        }
+        if (type === 'plan') {
+            return true;
+        }
+        if (type !== 'agentmessage' && type !== 'assistantmessage') {
+            return false;
+        }
+        const phase = item.phase?.toLowerCase() ?? null;
+        return phase === null || phase.startsWith('final');
     });
 }
 function mapGoalNotification(raw) {
@@ -8651,6 +8759,9 @@ function resolveScopeMessageTarget(scopeId) {
         return null;
     }
 }
+function restartPreviewRecoveryKey(preview) {
+    return `${preview.scopeId}:${preview.turnId}:${preview.messageId}`;
+}
 function seedObservedTurnCursor(turn) {
     const agentItems = turn.items.filter((item) => {
         const type = item.type.toLowerCase();

package/package.json

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