@foxden-app/foxclaw 0.5.27 → 0.5.29

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.29 - 2026-06-09
+
+### 中文
+- 重启自动续接遇到旧 Codex thread 永久 `thread not found` 时，会静默创建 replacement thread 并复用原 Telegram 状态卡继续跑，不再只反复等待旧 thread 恢复。
+- 自动续接提示补充了无上下文兜底指令：如果旧线程上下文不可用，会检查当前工作目录、git 状态、服务日志和运行状态后完成收尾总结。
+
+### English
+- Restart auto-resume now silently creates a replacement thread when the old Codex thread remains `thread not found`, reusing the original Telegram status card instead of only waiting for the old thread to recover.
+- The auto-resume prompt now includes a no-context fallback: inspect the current working directory, git status, service logs, and runtime state before finishing the user-facing summary.
+
+## 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
 
 ### 中文

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 });
@@ -2562,7 +2565,9 @@ export class BridgeSessionCore {
             }
             this.logger.warn('codex.turn_thread_not_found', { scopeId, threadId: binding.threadId });
             const replacement = await this.createBinding(scopeId, binding.cwd ?? this.config.defaultCwd);
-            await this.sendMessage(scopeId, t(this.localeForChat(scopeId), 'current_thread_unavailable_continued', { threadId: replacement.threadId }));
+            if (overrides.notifyMissingThread !== false) {
+                await this.sendMessage(scopeId, t(this.localeForChat(scopeId), 'current_thread_unavailable_continued', { threadId: replacement.threadId }));
+            }
             const nextSettings = this.store.getChatSettings(scopeId);
             const nextAccess = this.resolveEffectiveAccess(scopeId, nextSettings);
             const replacementCwd = replacement.cwd ?? this.config.defaultCwd;
@@ -7210,8 +7215,104 @@ 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)) {
@@ -7226,7 +7327,7 @@ export class BridgeSessionCore {
         }
         const snapshot = await this.app.readThreadSnapshot(preview.threadId);
         if (!snapshot) {
-            return false;
+            return preview.isObserved ? false : this.resumeInterruptedTurnAfterRestart(preview, target);
         }
         const liveTurn = findLiveTurn(snapshot);
         if (liveTurn) {
@@ -7305,7 +7406,7 @@ export class BridgeSessionCore {
         try {
             await this.sendTyping(preview.scopeId);
             const turnState = await this.startTurnWithRecovery(preview.scopeId, binding, input, {
-                recoverMissingThread: false,
+                notifyMissingThread: false,
             });
             if (turnState.collaborationMode === 'plan') {
                 this.store.setChatCollaborationMode(preview.scopeId, DEFAULT_COLLABORATION_MODE);
@@ -8660,6 +8761,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/dist/i18n.d.ts

@@ -418,7 +418,7 @@ declare const MESSAGES: {
         readonly stale_preview_restarted: "The bridge restarted while turn {threadId} was still live. This status card is no longer live. Open the thread in Codex.app or send another message to continue.";
         readonly stale_preview_expired: "This live preview expired after the bridge stopped tracking the turn. If a final reply arrived, see below. Otherwise send the message again.";
         readonly stale_user_input_interrupted: "The bridge found a stale Codex input request for thread {threadId} with no recoverable Telegram question. It interrupted that stuck turn; send the message again to continue.";
-        readonly restart_auto_resume_prompt: "FoxClaw restarted while the previous turn was running. Continue the interrupted work from where it left off.";
+        readonly restart_auto_resume_prompt: "FoxClaw restarted while the previous turn was running. Continue the interrupted work from where it left off. If the previous thread context is unavailable, inspect the current working directory, git status, service logs, and runtime state, then finish the user-facing summary.";
         readonly streaming_reply_below: "Streaming reply below...";
         readonly interrupt_requested_preview: "Interrupt requested...";
         readonly interrupt_requested_waiting: "Interrupt requested. Waiting for Codex to stop...";
@@ -1115,7 +1115,7 @@ declare const MESSAGES: {
         readonly stale_preview_restarted: "桥接在该线程 {threadId} 仍处于活动状态时重启了。这张状态卡已经不再实时更新。你可以去 Codex.app 打开线程，或重新发一条消息继续。";
         readonly stale_preview_expired: "之前的实时预览在桥接停止跟踪这轮回复后已经失效。如果下方已有最终回复，请以最终回复为准；否则请重新发送消息。";
         readonly stale_user_input_interrupted: "桥接发现线程 {threadId} 有一条已经无法恢复到 Telegram 的 Codex 输入请求，已中断这条卡住的回复。请重新发送消息继续。";
-        readonly restart_auto_resume_prompt: "FoxClaw 重启时上一轮回复仍在运行。请从中断处继续完成刚才的工作。";
+        readonly restart_auto_resume_prompt: "FoxClaw 重启时上一轮回复仍在运行。请从中断处继续完成刚才的工作。如果上一线程上下文不可用，请检查当前工作目录、git 状态、服务日志和运行状态，然后完成面向用户的收尾总结。";
         readonly streaming_reply_below: "回复正在下方持续输出...";
         readonly interrupt_requested_preview: "已请求中断...";
         readonly interrupt_requested_waiting: "已请求中断，正在等待 Codex 停止...";

package/dist/i18n.js

@@ -416,7 +416,7 @@ const MESSAGES = {
         stale_preview_restarted: 'The bridge restarted while turn {threadId} was still live. This status card is no longer live. Open the thread in Codex.app or send another message to continue.',
         stale_preview_expired: 'This live preview expired after the bridge stopped tracking the turn. If a final reply arrived, see below. Otherwise send the message again.',
         stale_user_input_interrupted: 'The bridge found a stale Codex input request for thread {threadId} with no recoverable Telegram question. It interrupted that stuck turn; send the message again to continue.',
-        restart_auto_resume_prompt: 'FoxClaw restarted while the previous turn was running. Continue the interrupted work from where it left off.',
+        restart_auto_resume_prompt: 'FoxClaw restarted while the previous turn was running. Continue the interrupted work from where it left off. If the previous thread context is unavailable, inspect the current working directory, git status, service logs, and runtime state, then finish the user-facing summary.',
         streaming_reply_below: 'Streaming reply below...',
         interrupt_requested_preview: 'Interrupt requested...',
         interrupt_requested_waiting: 'Interrupt requested. Waiting for Codex to stop...',
@@ -1113,7 +1113,7 @@ const MESSAGES = {
         stale_preview_restarted: '桥接在该线程 {threadId} 仍处于活动状态时重启了。这张状态卡已经不再实时更新。你可以去 Codex.app 打开线程，或重新发一条消息继续。',
         stale_preview_expired: '之前的实时预览在桥接停止跟踪这轮回复后已经失效。如果下方已有最终回复，请以最终回复为准；否则请重新发送消息。',
         stale_user_input_interrupted: '桥接发现线程 {threadId} 有一条已经无法恢复到 Telegram 的 Codex 输入请求，已中断这条卡住的回复。请重新发送消息继续。',
-        restart_auto_resume_prompt: 'FoxClaw 重启时上一轮回复仍在运行。请从中断处继续完成刚才的工作。',
+        restart_auto_resume_prompt: 'FoxClaw 重启时上一轮回复仍在运行。请从中断处继续完成刚才的工作。如果上一线程上下文不可用，请检查当前工作目录、git 状态、服务日志和运行状态，然后完成面向用户的收尾总结。',
         streaming_reply_below: '回复正在下方持续输出...',
         interrupt_requested_preview: '已请求中断...',
         interrupt_requested_waiting: '已请求中断，正在等待 Codex 停止...',

package/package.json

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